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Preface 


ng, and 
, but you 
also acts as a 
ms. 

Android is the fastest growing operating system, and Android devices can empower, 
entertain, and educate the planet. Android uses one of the most popular programming 
languages— Java, which is a high-performance, secure, and object-oriented language. 

pter, 

ting 

them to work by building Android games. 


What this book covers 

Chapter 1, Why Java, Android, and Games?, tells us why we might choose Java, 
Android, and games over other languages, platforms, and types of apps. Then we 
ng the 

Java Development Kit and Android Studio. 

Chapter 2, Getting Started with Android, shows us how to design, build, and run a game 
menu UI on a real Android device. This is the first part of our math game project. 

Chapter 3, Speaking Java - Your First Game, covers the Java fundamentals and their use 
in an Android environment to make a simple math quiz game. 

Chapter 4, Discovering Loops and Methods, contains more Java fundamentals such as 
decision-making and looping. Then we use them to add features to our math game. 
This chapter also covers some basic Android game essentials such as locking and 
handling screen rotation, and introduces the device sensors. 
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Chapter 5, Gaming and Java Essentials, takes us on a quick ride through some vital 

n and by 

ing 

the sequence with Java arrays and a for loop. 

Chapter 6, OOP - Using Other People's Hard Work, is the chapter where everything 
you have learned so far is tied up with a pretty ribbon. You should find yourself 
lore 

object-oriented programming (OOP) in this chapter. 

Chapter 7, Retro Squash Game, teaches us how to draw graphics pixel by pixel with the 
Android Canvas class. We can then combine these new skills with what we already 
know and make a retro, pong-style squash game. 

Chapter 8, Tire Snake Game, covers the beginning of our most advanced game project— 
an animated Snake- style arcade game. We will also be able to practice more of the 
important Java fundamentals that you learned in the previous chapters. 

Chapter 9, Making Your Game the Next Big Tiring, puts the icing on the cake by teaching 
you how to publish your game and add online leaderboards and achievements. This 
will also let you examine the concept of Java libraries. 

Appendix, Self-test Questions and Answers, contains all the answers to the questions to 
test your understanding of the topic. 

What you need for this book 

You will need a modest version of Windows (XP, Vista, 7, or 8), and a Mac, Linux 
software 

needed in excess of this is free and acquiring it is fully explained in the book. 


Who this book is for 

id, or game 

programming. As the book assumes no previous knowledge, it is also for you if you 
are new to all three (Java, Android, and game programming). 

sure where 

to start, then this book will show you what to do, step by step from the start. 


then this 
your 

existing skills in an Android context. 
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Java for 

any platform from the start, then you will be able to learn from this book and move 
through the practical examples more quickly. 

The book does assume that you are fairly confident in using your operating system 
decent 
y with 
them too. 


Conventions 

In this book, you will find a number of text styles that distinguish between different 
kinds of information. Here are some examples of these styles and explanations of 
their meanings. 

Code words in text, database table names, folder names, filenames, file extensions, 
pathnames, dummy URLs, user input, and Twitter handles are shown as follows: "In 
the Android Studio Project Explorer, double-click on the layout folder to reveal the 
activity_main . xml file within it." 

A block of code is set as follows: 

import android . support . v7 . app . ActionBarActivity ; 
import android . os . Bundle ; 
import android . view . Menu; 
import android . view . Menultem; 

, the 

relevant lines or items are set in bold: 

int partA = 9 ; 
int partB = 9 ; 

correctAnswer = partA * partB; 

int wrongAnswerl = correctAnswer - 1; 
int wrongAnswer2 = correctAnswer + 1; 

Any command-line input or output is written as follows: 

info: a = 10 

info: b = Alan Turing 

info: c = true 
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New terms and important words are shown in bold. Words that you see on the 
his: "When 

prompted to import another class, click on OK." 

Warnings or important notes appear in a box like this. 


Tips and tricks appear like this. 


Reader feedback 

Feedback from our readers is always welcome. Let us know what you think about 
r us as it 

helps us develop titles that you will really get the most out of. 

To send us general feedback, simply e-mail f eedback@packtpub . com, and mention 
the book's title in the subject of your message. 

If there is a topic that you have expertise in and you are interested in either writing 
or contributing to a book, see our author guide at www . packtpub . com/authors. 

Customer support 

Now that you are the proud owner of a Packt book, we have a number of things to 
help you to get the most from your purchase. 

Downloading the example code 

You can download the example code files from your account at http : / /www . 
packtpub . com for all the Packt Publishing books you have purchased. If you 
purchased this book elsewhere, you can visit http : / /www . packtpub . com/ support 
and register to have the files e-mailed directly to you. 

Downloading the color images of this book 

We also provide you with a PDF file that has color images of the screenshots/ 
diagrams used in this book. The color images will help you better understand the 
changes in the output. You can download this file from: http : //www . packtpub . 
com/ sites /default/ f iles/downloads/88590S_ColoredImages . pdf. 
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Errata 

mistakes 

do happen. If you find a mistake in one of our books — maybe a mistake in the text or 
g so, you can 

save other readers from frustration and help us improve subsequent versions of this 
book. If you find any errata, please report them by visiting http : / / www . packtpub . 
com/submit-errata, selecting your book, clicking on the Errata Submission Form 
link, and entering the details of your errata. Once your errata are verified, your 
te or added 

to any list of existing errata under the Errata section of that title. 

To view the previously submitted errata, go to https : //www . packtpub . com/books/ 
content /support and enter the name of the book in the search field. The required 
information will appear under the Errata section. 

Piracy 

oss all 

ry seriously. 

If you come across any illegal copies of our works in any form on the Internet, please 
provide us with the location address or website name immediately so that we can 
pursue a remedy. 

Please contact us at copyright@packtpub . com with a link to the suspected 
pirated material. 

We appreciate your help in protecting our authors and our ability to bring you 
valuable content. 

Questions 

t 

questions@packtpub . com, and we will do our best to address the problem. 
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1 

Why Java, Android, 
and Games? 


Welcome to Learning Java by Building Android Games, which I hope is just the 
beginning of your exciting journey into designing and writing games. By the 
h 

dynamically increasing difficulty, a memory game in the style of the classic 
Simon toy, a pong-style squash game, and a clone of the classic Snake game. 

Besides these games, we will build more than a dozen working apps to practice and 
demonstrate individual concepts to aid our learning of Java, Android, and games, 
ill learn 

everything from using the standard Android User Interface (UI) designer to creating 
smooth animations by plotting individual pixels. 

Although I will encourage you to work with me and implement the specific projects 
that are detailed step by step throughout the book, I fully expect that once you grasp 
ations 

without delay. This is exactly what I hope you will be inspired to do. 
eans to a 

much loftier goal. By the end of the book, you will be able to design and implement 
your own 2D Android games, to sell or just to give away, on Google Play. 

There is a bit of ground work to cover first, but I promise it 
won't take long and it won't be complicated either. Anyone 
can leam to program. 



Win/ Java, Android, and Games? 


S 

m. So it 

is a good idea to look at why learning Java, Android, and games is an ideal pathway 
for beginners. This will be the first thing we will discuss in this book. 

Here is what we will learn in this chapter: 

• Is this book for me? 

• Why should I use games to learn to program? 

• Why should I learn Java and Android? 

• Setting up our development environment 

Is this book for me? 

If you have already decided that Java, Android, or games are what you want to 
learn, then the next question might be, "Is this specific book for me?". 

mplished 

authors and programmers than myself. I have read many of them and admire the 
topics such 

as Java-native interfaces, web browser applets, or server-side remote communication, 
I sometimes find myself questioning their immediate relevance to me. 

learning 

process would slow or stop. 

If you just want to learn pure Java 

rt. Although the 

Android stuff might be considered overhead to your pure Java learning, this is much 
introduced 

in any other Java book. The only caveat with this book is that the necessary overhead 
an focus quite 
intently on Java. 

With regard to the amount of overhead: 

• It will take about six pages to set up our programming environment in 
this chapter 

• It will take Chapter 2, Getting Started with Android, to get familiar with the 
Android tools, create your first working project, and glimpse your first real 
Java code 

• From then on, it will be nearly pure Java and building games 
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is 

well worthwhile. 

If Android is your focus 

d to say this is 
the fi Java 

or programming knowledge whatsoever. 

Where this book will take you 

By the end of this book, you will be able to easily take one of many paths 
including these: 

• Learning Java at a higher level for any platform 

• Intermediate level Android learning including pure game frameworks 
(which will be covered in more detail in Chapter 9, Making Your Game the 
Next Big Tiring) 

• A higher level of games development 

• Much easier tackling of any modern object-oriented language for things 
such as iOS, Windows, or web development 

some way 
droid, or 
Java at all? 

Why build games to learn to program? 

Fun, of course! But there are other reasons too. Successfully running any program 
we have written is immensely satisfying, even more so when it involves using some 
code that we previously didn't understand. 

pleasure 
added bonuses 
ng them 

publicly on the Google Play Store, and you might realize that once you start making 
games, you can't stop. 

As we create more complex games steadily, you'll realize that all techniques and 
pieces of code can be rehashed to create other games, and you can then start 
the least. 
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mes are a 

perfect way to start learning to program Java. However, most beginners' books for 
ill see, it is 
nd still start 

with the very basics of Java, 
approach the 

working game examples in a "by-the-book" manner. This is to avoid the problem of 
doing cartwheels before mastering the forward roll. 

t, 

pies. 

and game 

programming fundamentals. 

Of course, from what we have just discussed, you can probably surmise that it would 

if we hadn't 

been making games. 

This is true, but then we lose all the benefits that come with using games as the 
e open and 
f learning 
the slightest, 

then there are plenty of Java beginners' guides out there that take the traditional 
ur first 

game with online leaderboards and achievements. 

Why Android and Java? 

A part of successful learning is the commitment by the student, not just to do the 
work, but in their belief that they are doing the right thing in the right way. So many 
ader, not 

subconsciously anyway. 

The problem is the students' belief that they might be, partly at least, wasting their 
ot quite 

right for them. This can be true to a large extent with programming. So why 
should you spend your finite time learning Java, on Android? 
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Android is the fastest evolving and growing 
OS ever 

they 

emerge about once in six months. By comparison, Windows takes years between 
versions and even iOS updates come only yearly and usually change relatively 
an 

unprecedented rate. 

Look at the history of Android versions since Version 1 at 
http : / /www. cnet . com/news/history-of -android/. 

The first humble version of Android was released in 2008, around the same time 
when consumers were already quite excited about the then much flashier iPhone, 
lling apps 

in the iTunes app store, 
ipped more 

Android units than Apple sold all iOS devices combined. I am not joining the war 
on whose devices are best. I enjoy aspects of both Android and Apple, but purely 
in terms of picking a platform to learn on, you are probably in the right place at the 
right time with Android. 

Android developers have great prospects 

that comes 
ng further, 

you will find that the demand for Android programmers is enormous and therefore 
very lucrative too. 

Some data suggests salaries in excess of 100,000 US dollars. For 
more information, go to http : / / www . indeed . com/ salary? 
ql=Android+Developer&ll=United+States. 
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Android is open source 

What open source means is that although Google develops all the flavors of Android 
that are used on the newest devices, once the code is released, anybody can do 
whatever they like with it. Google only exerts control for a limited amount of time. 

In practice, most Android users have the pure Google OS or the modified 
ere 

is nothing to stop anybody taking the OS and changing, adapting, or converting 
it into whatever they like. In short. Android could never be taken away from the 
programming community. 

Java is here to stay 

redundant? 

And will your significant time investment be wasted? On Android, as with most 
platforms, you can use many languages and tools. Android, however, was designed 
nd tools are 

not invalid but tend to serve a fairly specific purpose, rather than be a real alternative 
to Java. In fact, as far as games are concerned, many of the alternatives to a pure 
Java development environment are also Java-based and require a good level of skill 
, which 

allows you to simultaneously make games for Android, iOS, Windows, Linux, Mac 
and even the Web, still uses Java! We will talk more about this in Chapter 9, Making 
Your Game the Next Big Tiling. The point is that Java and Android are tied together 
and will likely thrive together. 

Java is not just for Android 

he 1990s in 

fact. Although what Java has been used for has evolved and diversified over more 
tself remain 
the same today. 

Java was designed to be platform- or computer-independent. This is achieved by the 
use of a virtual machine (VM). This is a program written in another language that 
latform 
to run your 
you learn 

Java, you are learning a language that is used everywhere from the smart fridge to 
the Web and most places in between. 
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mplement 

features to specifically suit the uses it is likely to be put to. A clear example of this 

would be mobile-device-specific features such as sensors, GPS, or the built-in camera 

on many Android devices. Using Java with Android, you can take photos, detect 

fridge VMs 

esigned for 

Java on 

assured that 

Java isn't going away any time soon. 

Java is fast and easy to use 

There is a decades-long debate over which language is the best overall or which 
language is the best to learn programming. Critics of Java will likely say things 
about Java's speed. It is true that the Java memory management along with the 
VM interpretation process does have some speed cost. However, these things have 
benefits; they significantly improve our productivity and the way that the Android 
since 

Android 4.4, it does so completely with Android Run Time (ART), which installs 
can build 

games in a friendly, interpreted language and have them run as if they were written 
in a more challenging natively compiled language. 

A summary of Java and Android 

ur precious 

learning time, it is hard to have more confidence. Here we have a language (Java) 
whose fundamentals have remained almost the same for nearly a quarter of a 
century, and a platform (Android) that is backed by the biggest names in hardware, 
software, and retail, and though it's admittedly hugely influenced, it's not actually 
owned by anyone. 

I am not an evangelist of any technology over another although it is true that I love 
considering 

the best path to begin learning programming, there is a very strong argument that 
Java and Android are the best choice. 

ery good place 
ment of any 
es has the 

enormous benefits we have already discussed. 
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By the end of the book, you will be able to write Java code for almost any 
n 

in this book, away from the Android environment. 

es or any 
inner s. 

mastering 

it— the fastest growing platform on the planet— then Learning Java by Building 
Android Games will probably be just right for you. 

So hopefully you are assured that the path this book will take to learn Java is as 
can start 
building games. 

Setting up our development environment 

The first thing we need to do is prepare our PC to develop for Android using Java. 
Fortunately, this is made quite simple for us. 

If you are learning on Mac or Linux, everything in this book 
will still work. The next two tutorials have Windows-specific 
instructions and screenshots. However, it shouldn't be too 
difficult to vary the steps slightly to suit Mac or Linux. 

All we need to do is: 

1. Install a software package called the Java Development Kit (JDK), which 
allows us to develop in Java. 

2. Install Android Studio, a program designed to make Android development 
fast and easy. Android Studio uses the JDK and some other Android-specific 
tools that automatically get installed when we install Android Studio. 

Installing the JDK 

The first thing we need to do is get the latest version of the JDK. To complete this 
guide, perform the following steps: 

1. You need to be on the Java website, so visit http : //www . oracle . com/ 
technetwork/ j ava/ j avase/downloads/ index . html. 
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2. Find the three buttons shown in the following screenshot and click on the 
one that says JDK (highlighted). They are on the right-hand side of the web 
page. Click on the DOWNLOAD button under the JDK option: 



3. You will be taken to a page that has multiple options to download the JDK. 
In the Product/File description column, you need to click on the option that 
matches your operating system. Windows, Mac, Linux and some other less 
common options are all listed. 

4. A common question here is, "do I have 32- or 64-bit windows?". To find out, 
right-click on your My Computer (This PC on Windows 8) icon, click on the 
Properties option, and look under the System heading in the System type 
entry, as shown in the following screenshot: 


System 






Manufacturer 

TOSHIBA 



Model: 

Personal Computer 



Rating: 

Windows Experience Index 


Processor 

Intel(R) Core(TM) i7 CPU 

Q 740 @ 1.73GHz 1.73 GHz 


Installed memory (RAM): 

8.00 GB 



System type: 

64-bit Operating System 



Pen and Touch: 

No Pen or Touch Input Is available for this Display 


5. Click on the somewhat hidden Accept License Agreement checkbox: 


You must accept the Oracle Binary 


i iccept License Agreement • 
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6. Now click on the download option for your OS and system type as 
previously determined. Wait for the download to finish. 

7. In your Downloads folder, double-click on the file you just downloaded. The 
latest version at time of writing this for a 64-bit Windows PC was j dk- 8u5 - 
windows -x6 4. If you are using Mac/ Linux or have a 32-bit OS, your filename 
will vary accordingly. 

8. In the first of several install dialogs, click on the Next button and you will see 
the next dialog box: 



9. Accept the defaults shown in the previous screenshot by clicking on Next. 
In the next dialog box, you can accept the default install location by clicking 
on Next. 

10. Next is the last dialog of the Java installer. Click on Close, 
able 

to use the JDK. 


[ 16 ] 




Chapter 1 


11 . Right-click on your My Computer (This PC on Windows 8) icon and 

navigate to Properties | Advanced system settings | Environment variables 
| New (under System variables, not under User variables). Now you can 
see the New System Variable dialog, as shown in the following screenshot: 



12. Type JAVA_HOME for Variable name and enter c : \Program Files\ 

Java\ jdki . 8 . 0_05 for the Variable value field. If you installed the JDK 
somewhere else, then the file path you enter in the Variable value: field 
will need to point to wherever you put it. Your exact file path will likely 
you 

downloaded it. 

13. Click on OK to save your new settings. Now click on OK again to clear the 

Advanced system settings dialog. 


tarting 

to learn Java programming, but we need a friendly way to interact with the JDK and 
to help us make Android games in Java. 

Android Studio 

We learned that Android Studio is a tool that simplifies Android development and 
er tools 

you can use instead of Android Studio. There are pros and cons in them all. For 

y things 

clipse 

instead of Android Studio. I use both, but what I hope you will love about Android 
Studio are the following elements: 

• It is a very neat and, despite still being under development, a very refined 
and clean interface. 

• It is much easier to get started compared to Eclipse because several Android 
tools that would otherwise need to be installed separately are already 
included in the package. 
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• Android Studio is being developed by Google, based on another product 
called IntelliJ IDEA. There is a chance it will be the standard way to develop 
Android in the not-too-distant future. 

If you want to use Eclipse, that's fine; all of the code in this 
book will work. However, some the keyboard shortcuts 
and user interface buttons will obviously be different. If 
you do not have Eclipse installed already and have no 
prior experience with Eclipse, then I even more strongly 
recommend you to go ahead with Android Studio. 



Installing Android Studio 

So without any delay, let's get Android Studio installed and then we can begin our 
first game project. To do this, let's visit https : //developer . android, com/sdk/ 
installing/ studio . html. 

1. Click on the button labeled Download Android Studio to start the Android 
studio download. This will take you to another web page with a very 
similar-looking button to the one you just clicked on. 

2. Accept the license by checking in the checkbox, commence the download by 
clicking on the button labeled Download Android Studio for Windows, and 
wait for the download to complete. The exact text on the button will probably 
vary depending on the current latest version. 

3. In the folder in which you just downloaded Android Studio, right-click on 
the android-studio-bundle-135 . 12465-windows . exe file and click on 
Run as administrator. The end of your filename will vary depending upon 
the version of Android Studio and your operating system. 

4. When asked if you want to Allow the following program from an unknown 
publisher to make changes to your computer, click on Yes. On the next 
screen, click on Next. 

5. On the screen shown in the following screenshot, you can choose which users 
of your PC can use Android Studio. Choose whatever is right for you as all 
options will work, and then click on Next: 
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6. In the next dialog, leave the default settings and then click on Next. 

7. Then on the Choose start menu folder dialog box, leave the defaults and 
click on Install. 

8. On the Installation complete dialog, click on Finish to run Android Studio 
for the first time. 

9. The next dialog is for users who have already used Android Studio, so 
assuming you are a first time user, select the I do not have a previous version 
of Android Studio or I do not want to import my settings checkbox, and then 
click on OK: 


Complete Installation 


You can import your settings from a previous version of Android Studio. 

O I want to import my settings from a custom location 

Specify config folder or installation home of the previous version of Android Studio: 


® | do riot have a pi rewi o^ or I d o not want to Im port my ^ settlS 

OK 


That was the last piece of software we needed. The simple nine-step process we just 
will begin 

to use in the next chapter. 
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Summary 

We discussed why games, Java, and Android are not only extremely exciting but 
also arguably the best way to learn to program. This is because games can be an 
trengths 
se for free. 

tting ready 

for the next chapter where we will actually create a part of a working game and take 
our first look at some Java code. 
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Getting Started with Android 


oid topics that 

you need to learn in order to get started with Java. It won't just be theoretical though. 
We will be designing a user interface (UI) of a game menu and we will see and edit 
our first Java code as well. 

ulator on 

our PC/ Mac or on a real Android device if we have one. 
g. That is, 

there is a lot more below the surface to some of the topics we discuss than would 
, we 

might need to take a bit of information on faith, 
app by 

the end of this chapter. Then we can start learning Java for real at the beginning of 
the next chapter. 

If this chapter seems a little tough, then don't worry; keep going because each 
topics. 

For this chapter and the next two, we will be building a math game. We will start 
simply and by the end of Chapter 4, Discovering Loops and Methods, we will scale to 
game features that use significant Java skills. 



Getting Started with Android 


In this chapter, we will: 

• Start our first game project 

• Explore Android Studio 

• Use the Android Studio visual designer to make our game UI 

• Learn about structuring our code for Android 

• Take our first look at some Java code 

• Build and install our game on an emulator and a real device 

Our first game project 

tudio. 
on your 

desktop's start menu or in the folder where you installed it. 



If you get any errors in a dialog box mentioning Privilege 
elevation, then try running Android Studio with administrator 
privileges. To do this, find the Android Studio icon by clicking 
on the Windows Start button and searching for Android 
Studio. Now right-click on the icon and click on Run as 
administrator. Do this every time you run Android Studio. 


Preparing Android Studio 

So with Android Studio and Java installed, we just need to add the latest versions of 
the Android API that we will use to make our first game. Here is what to do to install 
the API: 

1. From the menu bar at the top of the Android Studio UI, navigate to Tools 
| Android | SDK Manager. Scroll down in the Android SDK Manager 
window and select the checkbox for Android 4.4.2 (API 19). 


Note that because Android is evolving so quickly, by the time you read 



> [7] Android 4.4.2 (API 19) 
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2. Click on Install Packages. 

3. On the next screen, click on the Accept license checkbox and then click 
on the Install button. Android Studio will download and install the 
appropriate packages. 

est, 

prewritten code called an API that we will interact with throughout the book. 

Building the project 

1. Click on New Project... as indicated in the following screenshot: 
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2. The Create New Project configuration window will appear. Fill in the 

Application name field with Math Game Chapter 2 and Company Domain 

with packtpub . com (or you could use your own company website name 
here), as shown in the following screenshot: 
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3. Now click on the Next button. On the next screen, check that the Phone and 
Tablet checkbox has a tick in it. Now we have to choose the earliest version 
of Android we want to build our app for. Go ahead and play with a few 
sion 

he fewer 
nee 

is to select API 8: Android 2.2 (Froyo). Go ahead and do that now as shown 
in the next screenshot: 
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4. Click on Next. Now select Blank Activity as shown in the next screenshot 
and click on Next again: 



5. On the next screen, simply change Activity Name to MainActivity and 
click on Finish. 

By default, Android Studio shows a Tip of the day dialog every time 
it starts. Some of the tips might not make sense while you are still 
learning Java but many of them are really useful and reveal great 
shortcuts and other time savers. It is well worth taking a few seconds 
to read them when they show up. As already discussed. Android 
Studio is built from IntelliJ IDEA, and you can find a complete list 
of keyboard shortcuts at http : / /www . j etbrains . com/ idea/ 
webhelp/keyboard- short cuts -you- cannot -miss . html. 

6. Clear Tip of the day by clicking on Close. 
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If you are completely new to programming, then the code, options, and files 
o concern 

ourselves with most of them in order to learn Java. When the time does come to 
interact with the finer details, we will do things one step at a time. 

It might be hard to believe that at this stage, but we have just created our first 
working app. We could build and run it on an Android device, and soon we will. 

ame. 

Exploring Android Studio 

e part at a time 
ts of the UI so 

that we can refer to them easily as we progress through the book, 
the key 

parts of Android Studio. If you can, try and memorize the parts to make future 
discussions of them easier for you. 
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Here is a handy table that you can quickly refer to and remember which part of 
Android Studio we are referring to. What follows is a more detailed explanation 
of each area. 


Number 

Name 

1 

Project Explorer 

2 

The editor 

3 

Menu bar 

4 

Toolbar 

5 

Navigation bar 

6 

Important tool windows 


• Project Explorer (1): This is shown as 1 in the screenshot and is a bit like 
Windows Explorer. It shows us all the files and folders that have been 
generated for our project. We will do a number of things from here as the book 
continues. Actually, if you delve into the files and folders that Android Studio 
creates, the Project Explorer is not an exact mapping. It is slightly simplified 
and highlighted to make managing and exploring our project easier. 

• The Editor (2): As the name suggests, we will edit our Java code files here 
in the editor. However, as we will soon see, the Editor window changes 
depending on the type of file we are editing. We will also be viewing and 
editing UI designs here. 

• Menu bar (3): Like most programs, the Menu bar gives us access to the full 
functionality of Android Studio. 

• Tool bar (4): This contains lots of really useful one-click options to do things 
such as deploying and debugging our games. Hover the mouse cursor over 
an icon to get a pop-up tip and gain greater insight into each toolbar icon. 

• Navigation bar (5): Like a file path, this shows exactly where the file that is 
currently in the editor is located within the project. 

• Important tool windows (6): These are a number of tabs that can be popped 
up and popped down again by clicking on them. If you like, try some of them 
now to see how they work. 

Let's talk a bit more about the parts of the Android Studio UI and how the editor 
we are 
ath game. 
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Using the Android Studio visual designer 

The Android Studio editor window is a very dynamic area. It presents different file 
our project, 

it also made a basic UI for us. UIs in Android can be built-in Java code or, as we 
a. However, as 

we will investigate after we have built the UI of our game menu, to get the UI to do 
anything useful, we need to interact with it. This interaction is always done with Java 
code. The visual designer also generates the UI code for us. We will take a very quick 
look at that too. 

As the book progresses, we will mainly shy away from Android UI development, 
as that is a staple of more non-game apps. We will instead spend more time looking 
e regular 

Android UI has its uses, and the Android Studio visual designer is the quickest way 
to get started. 

Let's have a look at that now: 

1. In the Android Studio Project Explorer, double-click on the layout folder 
to reveal the activity_main . xml file within it. This should be easy to see 
unless you have collapsed the directories. If you can't see the layout folder, 
navigate to it using the Project Explorer. It can be found at Math Game 
Chapter2 / src/main/ res/layout via the Android Studio Project Explorer, 
as shown in the following screenshot: 


¥ MathGameChapter2 ohr»\ 

► Cl .idea 

► Cl gradle 

▼ C« Math Game Chapter 2 
► Cl build 
Cl libs 
T C] src 
▼ C] main 

▼ Cl java 

▼ Cl com. packtpub. math 
c b MainActivity 

▼ Ci res 

► Cl drawable-hdpi 

► Cl drawable-mdpi 

► Cl drawable-xhdpi 

► Cl drawable-xxhdpi 



► Cl menu 

► C] values 

► C values-w820dp 
AndroidManifestxml 
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2. Now double-click on activity_main.xml to open it in the editor window, 
ext 

screenshot. The following screenshot shows the entire contents of what 
previously contained just our code. As you can see, what was just a text 
ot: 



In the preceding screenshot labeled (1), called Palette, you can choose from 
the available Android UI elements and simply click and drag them onto your 
re you 
1UI 

view, you will see the Component Tree area (3). The component tree allows 
you to examine the structure of the complex UI and select specific elements 
more easily. Under this tree is the Properties panel (4). Here you can adjust 

things such as color and size or much more advanced properties. 
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Note the tabs labelled (5). These tabs allow you to switch between 
the two main views that Android Studio provides for this type 
of layout file. These views, as you can see, are Design and Text. 
The design view is the default view and is shown in the previous 
screenshot. The text view also shows your under-construction UI, 
but it shows the code that has been autogenerated for us instead 
of the Palette element and the component tree. 

We don't need to worry about this code as it is all handled for 
us. It can be good to look on this tab from time to time so that we 
can begin to understand what the design tool generates for us. 

But it is not necessary to do this to learn Java. This code is called 

extensible Markup Language (XML). 


3. Take a quick look at the Text tab, click on the Design tab when you're done, 
and we will move on. 

glimpse of 

the automatically generated code that it generates for us. We can take a closer look at 
some of the actual UI elements that we will be using in our project. 


Android UI types 

nts, 

ill 

introduce us to some of the possibilities as well as how to use them. We will 
then quickly use what we know to make our menu. 


TextView 

On the visual UI area, click on the words Hello world!. What we have just selected 
ne or 

large heading type text, which might be useful in our game menu. 
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Let's try dragging and dropping another TextView onto our visual UI: 

1. Directly under the Widgets heading in our palette, you can see there are 
multiple types of TextView. They are presented in the palette as Plain 
TextView, Large Text, Medium Text and Small Text. Drag and drop a Large 
Text widget onto our visual design. Don't let go straightaway. As you drag 

u 

can see what the designer looks like when the widget being dragged is 
positioned at the center: 
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2. Let go of the left mouse button where you want the widget to go. If you let 
ext 

will appear in the center as expected. 

3. Now we can play with the properties. In the Properties window, click just 
to the right of textSize. You might need to scroll to find it. Type loosp as 
the value and press the Enter key. Notice that the text gets much larger. We 
can refine the size of our text by increasing and decreasing the value entered 
here. The unit sp stands for scaled pixels, and is simply a measuring system 
that attempts to scale the text to an appropriate equivalent actual size across 
different screen densities. 




lOOsp 


4. Play with some more properties if you like and when you're done, click on 
the TextView we just created in the visual designer to highlight it. Then tap 
on the Delete key to get rid of it. Now delete the TextView that was present 
when we started — the one that says Hello world!. 


Layout elements 


on 

Properties 

window. This element is called a RelativeLayout. It is one of several layout element 
buttons, 

text, and so on. If you look at the top of the Palette window, you will see the main 
ur game 

menu in a moment. 


ImageView widgets 


Image Views unsurprisingly are for displaying images. In the standard Android UI, 
this is a really quick way to add our designers' artwork to our game: 

1. Drag and drop an ImageView element onto the design in the same way as 
you positioned the TextView a moment ago. The ImageView element can 
be found below the Widgets heading. Now position it centrally as before or 
play with the options by dragging it around the design. We will delete it in a 
real. 

2. In the Properties window, select the src property in the same way as you 
selected the textSize property previously. 
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3. Notice that after you select it, you have the option to click on ... to give you 
more options. Click on ... and scroll to the bottom of the list of options. These 
are all the image files that we can display in this ImageView. Just for fun, 
scroll to the bottom of the list, choose ic_launcher, and click on OK. We can 
uild 

an attractive game menu screen. 

4. Change the layoufcwidth property to I5 0dp and the layout:height property 
to I50dp. The unit dp is a way of sizing elements and widgets that remains 
relatively constant across devices with screens that have very different 
numbers of pixels. 

5. Delete the ImageView in exactly the same way as you deleted the other 
views previously. 


ButtonView 


The use of ButtonView is probably given away by its name. Try to click and drag a 
few buttons onto our layout. Notice that there are a few types of ButtonView, such as 
Small Button, Button, and, if you look further down the Widget list, ImageButton. 
We will be using the regular ButtonView, labelled simply as Button. 


Now we will do something with each of these Android UI elements combined to 
make our game menu. 



You can download the entire sample from the code 
download section of the book's companion website. 


Using the sample code 


All of the code in this book is organized in projects. If a project spans more than one 
chapter, a project is provided for each chapter in its finished state. This helps you see 
the project in 

Android Studio is explained as follows: 

1. Download the code for this book. 

2. In Android Studio from the menu bar, navigate to File | Close project. 

3. Now create a new blank project as we did previously. Browse to where you 
downloaded the code for this book. 

4. Navigate to the Chapter2/MathGameChapter2 folder. Here you will find 
the code for all the files we create in this chapter. 

5. Open the code files using a plain text editor such as the free Notepad++. 


[ 34 ] 


Chapter 2 


6. Copy and paste in your Android Studio project or just compare the code 
as you see it. 



Although every line of code required in this book is supplied for 
your convenience, you still need to create each project for yourself 
through Android Studio. You can then simply copy and paste 
either the code in its entirety in the file with the matching name, or 
just the part of the code that you might be struggling with. Keep 
in mind that if you create a project with a different package name, 
then you must omit the line of code that is the package name from 
the supplied code files. The reasons for this will be clearer when 
we talk more about packages later in the chapter. 


Let's actually see how to do it all for ourselves. 


Making our game menu 

For now we will just make our game menu functional. Later in Chapter 5, Gaming 
and Java Essentials, we will see how we can make it look good by adding some cool 
animation to make the menu more visually interesting and fun. 

Here is what we are aiming for in this tutorial: 
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Before you start coding, you should design your layouts on paper first. However, 
the Android Studio designer is so friendly there is a strong argument, especially 
for simple layouts, to refine your design actually in the layout designer. Perform 
the following steps to create the game menu: 

1. Delete all widgets from your designer by clicking on them one at a time 
and then tapping the Delete key on each in turn. Be careful not to delete the 
RelativeLayout layout element as we are going to use it as a base for all the 
other elements. 

2. Click and drag a Large Text element from the palette to the top center of 

can change properties in the Properties panel by clicking to the right of the 
property to be changed. Change the text property to My Math Game and size 
to 3 0sp. 

3. Click and drag an ImageView element from the palette to the center of the 
design, slightly below the previous TextView. Change the layout:width 
property to isodp and the layout:height property to I50dp. 

4. Now click and drag three buttons for Play, High Scores and Quit. Center 

as per our design shown previously. 

5. Click on the top button, configure the text property, and enter the 
value Play. 

6. Click on the middle button, configure the text property, and enter the 
value High Scores. 

7. Click on the lowest button, configure the text property, and enter the 
value Quit. 

8. As the buttons now contain different amounts of text relative to each other, 
they will be of slightly different sizes. You can even them up to match the 
intended layout by clicking and dragging the edges of the smaller buttons 
to match the larger ones. This is done in mostly the same way as you might 
resize an application window in Windows. 

9. Save the project with Ctrl + S or by navigating to File | Save All. 
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If you are going to be testing your games on a much larger or 
much smaller screen than the Nexus 4 shown in the designer, 
then you might like to adjust the values of the sp and dp 
units used in this tutorial. 

A full discussion of Android UI on multiple devices is beyond 
the scope of this book and is not necessary to make any of the 
games in this book. If you want to start designing for different 
screens right away, take a look at http : / / developer . 
android . com/ training/multiscreen/ index . html. 


ing the 

device from the drop-down menu shown in the following screenshot: 


- (§)Theme ' MalnActivity- 1 * 'PP'IS” 



Nexus 5 (5.0", 1080 * 1920: xxhdpi) 

Nexus 7 (7.0", 1200 x 1920: xhdpi) 

Nexus 4 (4.7", 768 x 1280: xhdpi) 

Nexus 10 (10 2560 x 1600: xhdpi) 

Nexus 7 (2012) (7.0", 800 x 1280: tvdpi) 
Galaxy Nexus (4.7", 720 x 1280: xhdpi) 
Nexus S (4.0", 480 x 800: hdpi) 

Nexus One (3.7", 480 x 800: hdpi) 

101" WXGA (Tablet) (1280 x 800: mdpi) 
7.0" WSVGA (Tablet) (1024 x 600: mdpi) 
5.4" FWVGA (480 x 854: mdpi) 

51" WVGA (480 x 800: mdpi) 

4.7" WXGA (1280 x 720: xhdpi) 

4.65" 720p (720x 1280: xhdpi) 

4.0" WVGA (480 x 800: hdpi) 

3.7’ FWVGA slider (480 x 854: hdpi) 

3.7’ WVGA (480 x 800: hdpi) 

3.4m WQVGA (240 x 432: Idpi) 

33’ WQVGA (240 x 400: Idpi) 

33’ QVGA (ADP2) (320 x 480: mdpi) 

33" HVGA slider (ADP1) (320 x 480: mdpi) 
2.7’ QVGA slider (240 x 320: Idpi) 

2.7" QVGA (240 x 320: Idpi) 

Add Device Definition... 

Preview All Screen Sizes 


ame 


Before we make our menu come to life on an actual device, let's take a look at the 
ng our 
Java code. 
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Structuring our code for Android 

If you have ever used an Android device, you have probably noticed that it works 
e using 
Then you 

get an e-mail notification and you tap the e-mail icon to read it. Midway through 
reading the e-mail, you might get a Twitter notification and because you're waiting 
ding and 

change the app to Twitter with a touch. 

After reading the tweet, you fancy a game of Angry Birds, but midway through the 
first daring fling, you suddenly remember that Facebook post. So you quit Angry 
Birds and tap the Facebook icon. 

Then you resume Facebook, probably at the same point you left it. You could have 
entirely new 
the part of 
emselves. 

The difference between a Windows PC and Android in the context we have just 
discussed is that with Android, although the user decides which app they are using, 
the Android OS decides if and when to actually close down (destroy) an application. 
We just need to consider this when coding our games. 

Life cycle phases - what we need to know 

The Android system has different phases that any given app can be in. Depending 
on the phase, the Android system determines how the app is viewed by the user or 
whether it is viewed at all. Android has these phases so that it can decide which app 
is in current use and then allocate the right amount of resources such as memory and 
processing power. But also allow us as game developers to interact with these phases. 
What if someone quits our game to answer a phone call? Will they lose their progress? 

Android has a fairly complex system that, when simplified a little for the purpose 
the 

following phases: 

• Being created 

• Starting 

• Resuming 

• Running 

• Pausing 
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the user 

presses the Facebook app icon and the app is created. Then it is started. All are fairly 
straightforward so far but next in the list is resuming! It is not as illogical as it might 
fier it starts, 

and then all will become clear as we proceed. 

After resuming, the app is running. This is when the Facebook app has control over 
g power, 
e 

e-mail app? 

As we tap to go to read our e-mail, the Facebook app will probably have entered 
the paused phase, and the e-mail app will enter the being created phase followed 
by resuming and then running. If we decide to revisit Facebook, as in the scenario 
earlier, the Facebook app will probably then go straight to the resume phase and 
then running again, most likely exactly on the post where we left it. 

Note that at any time. Android can decide to stop or destroy an app, in which case, 
when we run the app again, it will need to be created all over again. So had the 
Facebook app been inactive long enough or had Angry Birds required so many system 
resources that Android would have destroyed the Facebook app, then our experience of 
finding the exact post we were previously reading might have been different. 

Now, if all this phase stuff is starting to get confusing, then you will be pleased to 
know that the only reasons to mention are as follows: 

• You know it exists 

• We occasionally need to interact with it 

• We will take things step by step when we do 

Life cycle phases - what we need to do 

ty? 

The good news is that the Android code that was autogenerated when we created 
our first project does most of the interaction for us. 

All we have to do as game developers is make sure that Android knows what to 

at all of 

ling. 
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come to 

ifically in 

one of the phases. 

Dividing our game into activities 

d activities. 

e, during 
y for the game 

screen and an activity for the high score screen. 

Each activity will have its own life cycle and will be further divided into parts that 
will correspond to (go into) one of the Android phases we just discussed. The parts in 
Java are known as methods. Methods are a significant concept in Java programming. 

At this stage, however, all we need to know is that methods are used to 
compartmentalize the Java code we write and that some methods are provided by the 
Android system so that we can easily handle the otherwise complex Android life cycle. 

ndroid for 

our convenience, to manage the phases of the life cycle. To clarify our discussion of 
that we have 

been discussing. However, as you will see, the method names make it fairly clear on 
their own where they fit in. 

In the list, there is also a brief explanation or suggestion about when we should use 
a given method and thereby interact during a specific phase. We will meet most of 
these methods as we progress through the book. We will see the onCreate method 
later in this chapter. Here is the list: 

• onCreate: This method is executed when the activity is being created. 

Here we get everything ready for the game, including graphics, sound, 
and perhaps the high scores. 

• onstart: This method is executed when the app is in the starting phase. 

• onResume: This method runs after onstart but can also be entered, perhaps 
sed. 

interrupted, perhaps by a phone call or the user running another app. 

• onPause: This occurs when our app is pausing. Here we might want to save 
the current game. You are probably getting the hang of these methods. 

• onstop: This relates to the stopping phase. This is where we might undo 
everything we did in onCreate. If we reach here, our activity will probably 
get destroyed sometime soon. 
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• onDestroy: This is when our activity is finally being destroyed — our last 
chance to dismantle our game. If we reach here, we will definitely be going 
through the phases of the life cycle from the beginning again. 

ghtforward. 

Perhaps, the only real question is about the running phase. As we will see, when 
we write our code in other methods/ phases, the onCreate, onStart, and onResume 
.The 

onPause, onStop, and onDestroy methods will occur afterwards. Now we can 
ell. 


Our first look at Java 

d our 
ife. Let's 

take a closer look. The very first line of code in the editor window is this: 

package com . packtpub . mathgamechapter2 ; 

This line of code defines the package that we named when we first created the 
project. As the book progresses, we will write more complex code that spans more 
than one file. All the code files we create will need the package they belong to, 
clearly defiy do 

anything in our game. Notice also that the line ends with a semicolon ( ; ). This is a 
part of the Java syntax and it denotes the end of a line of code. Remove a semicolon 
two lines 

together. Try it if you like. 



Remember that if you are going to be copying and pasting the 
code from the download bundle, this is the one line of code 
that might vary depending on how you set up your project. If 
the package name in the code file is different from the package 
name you created, always use the package name from when 
you created the project. 
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+ icon to 
of the code. 

Notice that there are several little - icons as well down the side of the editor window. 
Y ou can expand and collapse them to suit yourself without affecting the functionality 
of the program. This is shown in the following screenshot: 



package com.packtpub.mathg 


^in 

port . . . 


public class MainActivity 


Once you have expanded the code, you will see these four lines: 

import android . support . v7 . app . ActionBarActivity; 
import android . os . Bundle ; 
import android . view . Menu; 
import android . view . Menultem; 

Notice that all the preceding lines start with the word import. This is an instruction 

gnificant 

rs, the 

Android development team in this case. It is precisely these imports that give us the 
t with the 

micolon ( ;). 

class. 

understanding of throughout the book. For now, take a look at this line of code, 
then we will discuss it in detail: 

public class MainActivity extends ActionBarActivity { 


ke 

me a new public class called MainActivity and base it upon (extends) 
ActionBarActivity. 

You might remember that MainActivity is the name we chose while creating this 
project. ActionBarActivity is the code (known as a class) written by the Android 
development team that enables us to put our Java into Android. 
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d of this 

line. There is, however, an opening curly brace ({). This is because MainActivity 
encompasses the rest of the code. In effect, everything is part of our MainActivity 
class, which is built based on the ActionBarActivity class/ code. If you scroll 
ace ( }). This 

denotes the end of our class called MainActivity. 

• We do not need to know how a class works yet 

• We will use classes to access some methods contained within its code and 
without doing any more, we are already, by default, taking advantage of the 
Android life cycle methods we discussed earlier 

• We can now pick and choose if, when, and which methods defined in these 
classes we wish to override or leave as default 

So, it is the ActionBarActivity class that contains the methods that enable us 
different 
sing 

ActionBarActivity to a more appropriate class that also does all the things 
just mentioned. 



It is not important at this point to properly understand Java 
classes; just understand that you can import a package and a 
package can contain one or more classes that you can then use 
the functionality of or base your own Java programs on. 

We will bump into classes regularly in the next few chapters. 
Think of them as programming black boxes that do stuff. In 
Chapter 6, OOP - Using Other People's Hard Work, we will open 
the black box and really get to grips with them and we will 
even start making our own classes. 


ithin our 

class actually does, 
discussing: 

@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

} 

h what we 

have already discussed. Although the precise syntax will still feel a little alien, we 
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The first thing we notice in the preceding code is the word ©override. Remember 
cle were 
e them? 

This is what we are doing here with the onCreate method. 

The ©override word says that the method that follows next is being overridden. The 
protected void onCreate (Bundle savedlnstanceState) { line contains the 
method we are overriding. You might be able to guess that the action starts with the 
opening { at the end of the line in question and ends with the closing } three lines later. 

The somewhat odd-looking protected void before the method name onCreate 
and (Bundle savedlnstanceState) after the method name are unimportant at this 
vels between 
e will 
become 

clear in Chapter 4, Discovering Loops and Methods. Let's move on to the line: 
super . onCreate ( savedlnstanceState) ; 

Here, the super keyword is referencing the code in the original onCreate method, 
which is still there even though we can't see it. The code is saying: even though I am 
overriding you, I want you to set things up, just like you normally do first. Then, after 
onCreate has done loads of work that we don't see and don't need to see, the method 
continues and we actually get to do something ourselves with this line of code: 

setContentView (R . layout . activity_main) ; 

een), which 

is the cool game menu we created earlier. To be specific, we are stating it is an R or 
resource in the layout folder and the file is called activity_main. 

Cleaning up our code 

The next two blocks of code were created by Android Studio on the assumption 
ey are 

methods more often used in non-gaming apps: 

1. Delete the entire content shown in the following code. Be careful not to delete 
the closing curly brace of our MainActivity class: 

©Override 

public boolean onCreateOptionsMenu (Menu menu) { 

// Inflate the menu; this adds items to the action bar if 
it is present . 

getMenuInf later ( ) . inf late (R . menu . main, menu) ; 
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return true; 

} 


©Override 

public boolean onOptionsItemSelected (Menultem item) { 

// Handle action bar item clicks here. The action bar will 
// automatically handle clicks on the Home/Up button, so 

long 

// as you specify a parent activity in AndroidManif est . 

xml . 

int id = item . getltemld ( ) ; 
if (id == R . id . action_settings) { 
return true; 

} 

return super . onOptionsItemSelected ( item) ; 

} 

2. Now we can delete a couple of the @import statements. The reason for this is 
that we just deleted the overridden methods of classes (imported earlier) we 

grey- 

Note that the program would still work if you leave them in. Delete them 
both now to make your code as clear as possible: 
import android .view . Menu ; 
import android . view . Menultem ; 

3. Some final amendments before our code is done: at this point, you might 
be thinking that we have deleted and changed so much of our code that we 
lmost 

us 

and then making these amendments is more thorough and also avoids quite 
a few steps. Here are the last code changes. Change the import android . 
support ,v7 . app . ActionBarActivity; line to import android . support . 
app .Activity ; . 

4. Now you will get several red lines underlining our code and indicating 

imported. Simply amend the public class MainActivity extends 
ActionBarActivity { line to public class MainActivity extends 
Activity {. 

riate 

version of the Activity class. To do this, we also had to change what we imported. 
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When you're done, your editor window should look exactly like this: 
package com . packtpub . mathgamechapter2 . mathgamechapter2 ; 

import android . support . v7 . app .ActionBarActivity; 
import android . os . Bundle ; 

public class MainActivity extends ActionBarActivity { 
©Override 

protected void onCreate (Bundle savedlnstancePhase) { 
super . onCreate (savedlnstancePhase) ; 
setContentView (R . layout . activity_main) ; 


} 



Downloading the example code 

You can download the example code ties from your account at 
http : / / www . packtpub . com for all the Packt Publishing books 
you have purchased. If you purchased this book elsewhere, you 
can visit http : / / www . packtpub . com/ support and register to 
have the ties e-mailed directly to you. 


Now that 

take a look at the beginnings of our game in action! 



If any of what we have just discussed seemed complicated, 
there is no need for concern. Android forces us to work within 
the Activity lifecycle, so the previous steps were unavoidable. 
Even if you didn't follow all the explanations about classes and 
methods and so on, you are still perfectly placed to learn Java 
from here. All the classes and methods will seem much more 
straightforward as the book progresses. 


Building and installing our game 

need to find 
will 

put these together and put our game into an emulator or real device to see it as our 
players would. 
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Emulators and devices 


Now we have the first part of our game ready to run. We need to test it to check for 
o ensure that it 

looks good and runs correctly on the device types/ sizes and that you want to target. 


We will not go into any details about handling different device 
types. All our games are fullscreen and we will later lock the 
orientation and dynamically calculate aspects such as screen 
resolution. So we can get away with writing for a single device type 
and focus on learning Java. 

It might be useful to know for now that you can create a different 
layout file for any screen size categorization or pixel density. 



All you need to do is place the layout file using exactly the same 


filename in the appropriate folder. The Android device will then 
know the most appropriate layout for it to use. For a detailed 
discussion, see the Google developers website at http : // 
developer . android . com/guide/practices/ screens_ 
support . html. 

Note that you do not need to understand any of the information at 
the preceding link to learn Java and publish your first games. 


11 use Android 

Studio and tire Android Development Tools to make a device emulator so that we 
n the same 

PC/Mac we are developing on. So we don't need to own a device. This will allow us 
to get crash reports from our games. 

ee exactly what 

the owner of that device will see when they download our app. 

There are more options. For example, you can connect a real device via USB and 
Android 

Studio. The process for this might vary for different devices and since we won't be 
focusing on anything but basic debugging, we will not cover that in this book. 
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Creating an emulator 

Let's get our emulator up and emulating: 

1. On the right-hand side of the Android Studio quick launch bar, find the 
AVD manager icon: 


[Math Game Chapter 1] - ...\Math Game Chapti 




ik * m $ 

L 

MM o 

□ '*• ? 

pub mathgarr 

techap 

terl mathgamer 

/ity.java x 




2. Click on the icon to start the Android Virtual Device Manager. Then click on 
the Create Virtual Device... button on the bottom-left side to bring up the 
Virtual Device Configuration window. 

3. Now click on the Nexus 4 option and then click on Next. 

4. Now we need to choose the version of Android we will use to build and test 
our games on. The latest version (at time of writing) is Lollipop - 21 - x86. It 
e. 

is) and 

then click on Next to continue. 

5. On the next screen we can leave all the default settings. So click on Finish. 
We now have a ready-to-run Android emulator. 


Running the emulator 

r game that 

we made earlier by performing the following steps: 

1. Click on Nexus 4 API 21 under the Name column. Now click on the 
triangular play icon to the right of the description of our emulator. 



Android emulators take a long time to start. Even on 
a high-specification PC. Expect to wait at least a few 
minutes or even 10. 


] 
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2. Once it has started, unlock the device by clicking and dragging anywhere on 
the screen of the emulated device. This is analogous to swiping to unlock a 
is 

running and unlocked: 
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You cand 

device. However, you cannot download apps from Google Play. You might notice 
to an old 

one. Shortly, we will look at running our apps on a real device. 
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Running our game on the emulator 

Once the emulator is running, it's usually best to leave it running so that each time 
emulator: 

1. Launch the emulator if it is not already running and make sure the device is 
unlocked as described previously. 

2. Click on the run icon in the toolbar (shown next) to run your app. You can 
achieve the same thing by navigating to Run | Math Game Chapter 2 from 
the menu bar: 


•fl 1 Math Game Chapter 1 ▼ 


m R. 


3. After a pause while Android Studio builds our application, a pop-up dialog 

with Nexus 4 API 21 in the description. This is the already running device 
that we created earlier. Now press OK. 

4. Notice at this point that the useful Android window appears at the bottom 
section of Android Studio. In the unlikely event of you having any problems, 
go back 

to the Using the sample code section to compare with or copy and paste the 
supplied code. 

f course, 

it doesn't do anything yet, but it is running and the buttons can be pressed, 
cation, just 

as you would on a real Android device. 

Now we have seen one of the ways we can test our app by running it in the Android 
emulator. Let's find out how to make our code into an app we can distribute and use 
on a real device. 


Building our game 

To run our game on a real Android device, we need to create a . apk file, that is, a file 
that ends with the extension . apk. A . apk file is a compressed archive of files and 
re the steps 

to use Android Studio to make a . apk of our game: 

1. From the menu bar, navigate to Build | Generate Signed APK. 
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2. A slightly verbose window will pop up and say: For Gradle-based projects, 
the signing configuration should be specified in the Gradle build scripts. 

You can safely dismiss this window by clicking on OK. 

3. Next up is the Generate Signed APK Wizard dialog. Here, we are creating 
a key that identifies the key holder as authorized to distribute the APK. At 
the end of this process, you will have a . keys file that you can use each time 
you build a . apk file. So this step can be missed out in future. Click on the 
Create new button. 

4. In the Key Store Path field, type or go to a location on your hard drive where 
you would like to store your key. You will then be prompted to choose a 
filename for the keystore. This is arbitrary. Type MyKeystore and click on OK. 

5. Type a password in the Password field and then retype it in the Confirm 
field. This is the password to a store that will help protect your key. 

6. Next, in the Alias field, type a memorable alias. You can think of this as a 
kind of username for your key. Again type a password in the Password field 
and then retype it in the Confirm field. This is the password to your key. 

7. Leave the Validity Years dropdown at the default of 25. 

8. You can then fill out your Name and organization details (if any) and click 
on OK. 

9. Now our key and keystore are complete, and we can click on OK on the 

Generate Signed APK wizard dialog. 

10. We are then prompted to select Run Proguard. Encrypting and optimizing 
our . apk is unnecessary at this time. So just click on Finish to generate our 
app's .apk file. 

11. The generated . apk file will be put in the same directory that you chose to 
put the project files. For example, MathGameChapter2/app. 

We have now built a . apk file that can be run on any Android device that was 
specified when we first created the project. 

Installing the setup to a device 

So we have our . apk file and we know were to find it. Here is how we will run it on 
our Android device. 
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We can use one of a number of methods to get the . apk file into the device. The 
method I find one of the easiest is the use of a cloud storage service such as Dropbox. 
You can then simply click and drag the . apk file to your Dropbox folder and you're 
zation 

software that allows you to drag and drop files to and from your device. After you 
have placed the . apk file on your Android device, continue with the tutorial. 

Most Android phones are set not to install apps from anywhere except the Google 
to might 

vary very slightly on your device but the following options tend to be almost the 
same on most devices, old and new: 

1. Find and tap the Settings app. Most Android phones also have a Settings 
menu option. Either will do. Now select Security and scroll down to the 
Unknown sources option. Tap the Unknown sources checkbox to allow 
apps to be installed from unknown sources. 

2. Locate the file on your Android device using the Dropbox app or your 
devices file browser depending on the method you chose to put the APK on 
your device. Tap the MathGameChapter2 . apk file. 

3. You can now install the app just like any other. When prompted, press 
Install and then Open. The game will now be running on your device. 

igned. 

e this more 
user friendly. 

Future projects 

ely up to 

you which of the methods we discussed you prefer. If you are getting crashes or 
ng well, then 

the quickest and probably most pleasing way will be to run it on a device you own. 

Self-test questions 

Ql) What should you do if all this talk of life cycles, classes, and methods is 
a bit bemusing? 

Q2) What exactly is a Java class? 

Q3) What is the difference between a method and a class? 


[ 52 ] 



Chapter 2 


planation 

of the phases of the life cycle at http : / /developer . android, com/ reference/ 
android/app /Activity . html. Can you see the phase and its related method that 
we haven't discussed? When would it be triggered in an app? What is the precise 
pathway an activity takes from creation to destruction? 

Summary 

derstand 
ner for the 
pics such 

as methods in Chapter 4, Discovering Loops and Methods, and classes in Chapter 6, 

OOP - Using Other People's Hard Work, we will begin to make sense of all of the 
code in our games. 

We discussed the somewhat complex Android life cycle in detail. We learned that all 
n the correct 
have no trouble 

making good progress with learning Java. As with classes and methods, all will be 
explained along the way and become clearer with practice. 

rt menu for 
the Java 

code necessary to make the game appear on the player's device. This was achieved 
mainly by modifying the code that was automatically generated for us. 

This was probably the most difficult chapter of the book because it was necessary to 
introduce a few things such as Java classes, Java methods, and the Android life cycle, 
rn Java. 

cal manner, 
toughest of 

the projects in this book. 

If this chapter made your brain ache a little, rest assured that the fact that you have 
va ace someday 

soon. Starting from the basics, let's learn some Java now. 
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First Game 


In this chapter, we will start writing our very own Java code at the same time as we 
begin understanding Java syntax. We will learn how to store, retrieve, and manipulate 
different types of values stored in the memory. We will also look at making decisions 
and branching the flow of our code based on the values of this data. 

In this order, we will: 

• Learn some Java syntax and see how it is turned into a running app 
by the compiler 

• Store data and use it with variables 

• Learn how to express yourself in Java with expressions 

• Continue with the math game by asking a question 

• Learn about decisions in Java 

• Continue with the math game by getting and checking the answer 
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Acquiring the preceding Java skills will enable us to build the next two phases of 
ltiplication, 
n the 

following screenshot: 



Java syntax 

echnical 

things. You will never be asked to read a technical explanation of a Java or Android 
concept that has not been previously explained in a non-technical way. 

Occasionally, I might ask or imply that you accept a simplified explanation in order 
to offer a fuller explanation at a more appropriate time, like the Java class as a black 
ur head 

around a big word or a jargon-filled sentence. 
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o speak 

in technical terms and to join in and learn from these communities, you need to 
rn a concept 

or appreciate an idea using an entirely plain speaking language, but at the same 
time, it introduces the jargon as part of the learning. 

a way of 
clarifit 
needs to be. 

0 what is it? 

The Java syntax is the way we put together the language elements of Java in order 
ould also 
evisit our 
use and 

the formation of those words into sentence like structures. 

These Java elements or words are many in number, but when taken in small chunks 
reason 

for this is that the Java language and its syntax were specifically designed to be as 
straightforward as possible. We also have Android Studio on our side, which will 
ad and 
prompt us. 

1 am confivery 

easy. What then separates someone who has finished an elementary Java course from 

e from a 

study. 

In the last chapter, I will show you the right direction if you want to go on to master 
Java yourself. 

The compiler 

The compiler is what turns our human-readable Java code into another piece of code 
that can be run in a virtual machine. This is called compiling. The Dalvik virtual 
machine will run this compiled code when our players tap on our app icon. Besides 
compiling Java code, the compiler will also check for mistakes. Although we might 
still have mistakes in our released app, many discovered when our code is compiled. 
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Making code clear with comments 

use to 
e, as 
having 

us divide our code into separate chunks, very often across multiple files. 

Comments are a part of the Java program that do not have any function in the 
mmer 
ble to 
or 

modify the code, 
s: 


//this is a comment explaining what is going on 

The preceding comment begins with the two forward slash characters, //. The 
t. So 

anything on that line is for humans only, whereas anything on the next line 
ode: 

//I can write anything I like here 
but this line will cause an error 

We can use multiple single-line comments: 

//Below is an important note 
//I am an important note 

//We can have as many single line comments like this as we like 

line of code. 

We can put // 

this code, which tells Android to load our menu UI: 

/ / setContentView (R . layout . activity_main) ; 

have a 
iler. There is 
for longer 

comments and also to add things such as copyright information at the top of a code 
fiable code, in 

this case usually multiple lines. 


[ 58 ] 



Chapter 3 


Everything in between the leading / * signs and the ending * / signs is ignored by the 
compiler. Here are some examples: 

/* 

This program was written by a Java expert 
You can tell I am good at this because my 
code has so many helpful comments in it . 

*/ 

ype of 
ill always 

explain every line of code explicitly but you will often find liberally sprinkled 
clarification. 

So it's always a good idea to read all of the code: 

/* 

The winning lottery numbers for next Saturday are 
9 , 7 , 12 , 34 , 29,22 

But you still want to learn Java? Right? 

*/ 

All the best Java programmers liberally sprinkle their 
code with comments. 


Storing data and using it with variables 

We can think of a variable as a labeled storage box. They are also like a programmer's 
window to the memory of the Android device, or whatever device 
), ready 

to be recalled or altered when necessary by using the appropriate label. 

Computer memory has a highly complex system of addressing that we, fortunately, 
convenient 

names for all the data that we want our program to work with; the JVM will handle 
all the technicalities that interact with the operating system, which in turn, probably 
through several layers of buck passing, will interact with the hardware. 

So we can think of our Android device's memory as a huge warehouse. When we 
hen we 
t we are 

referring to. We can then tell it to do things such as "get box A and add it to box C, 
delete box B," and so on. 
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ines of 

score. It would be this score variable that we use to manage anything related 
to the user's score, such as adding to it, subtracting or perhaps just showing it to 
the player. 

Some of the following situations that might arise: 

• The player gets a question right, so add 10 to their existing score 

• The player views their stats screen, so print score on the screen 

• The player gets the best score ever, so make hiscore the same as their 
current score 

s you 
tually call 
opt a naming 
we will use 
hen there 
with an 

uppercase letter. This is called "camel casing." 

Here are some examples of camel casing: 

• score 

• hiScore 

• playersPersonalBest 

Before we look at some real Java code with some variables, we need to first look at 
the types of variables we can create and use. 

Types of variables 

It is not hard to imagine that even a simple game will probably have quite a 
few variables. In the previous section, we introduced the hiscore variable as 
ames 

of the top 10 players? Then we might need variables for each player, 
r is 

that tests 
playable 

character is dead. 

Another common requirement in a computer program, including games, is the right 
or wrong calculation: true or false. 
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p track 

of, Java has types. There are many types of variables and, as we will see in Chapter 6, 
OOP - Using Other People's Hard Work, we can also invent our own types or use other 
people's types. But for now, we will look at the built-in Java types. To be fair, they 
Some examples 

are the best way to explain this type of stuff. 

We have already discussed the hypothetical but highly likely score variable. The 
variable score is likely to be a number, so we have to convey this (that the score 
is a number) to the Java compiler by giving the score an appropriate type. The 
hypothetical but equally likely playerName will, of course, hold the characters that 
make up the player's name. Jumping ahead a couple of paragraphs, the type that 
holds a regular number is called int, and the type that holds name-like data is called 
string. And if we try and store a player name, perhaps "Ada Lovelace" in score, 
which is meant for numbers, we will certainly run into trouble. 

The compiler says no! Actually, the error would say this: 


score = "Ada Lovelace" 

Incompatible types. 
Required: int 

Found: java. la ng. String 
expected 


As we can see, Java was designed to make it impossible for such errors to make it to 
ad forgotten 
errors, what 

could possibly go wrong? 
hem: 


• int: This type is used to store integers. It uses 32 pieces (bits) of memory 
billion, 

including negative values. 

• long: As the name hints at, this data type can be used when even larger 
numbers are required. A long data type uses 64 bits of memory and 2 to the 
hat 

looks like, try this: 9,223,372,036,854,775,807. Perhaps surprisingly, 
there are uses for long variables but if a smaller variable will do, we should 
use it so that our program uses less memory. 
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You might be wondering when you might use numbers of this 
magnitude. The obvious examples would be math or science 
applications that do complex calculations but another use might 
r-'grX be for timing. When you time how long something takes, the Java 
— Date class uses the number of milliseconds since January 1, 1970. 

The long data type could be useful to subtract a start time from 
an end time to determine an elapsed time. We will use long in 
Chapter 5, Gaming and Java Essentials. 

• float: This is for floating-point numbers, that is, numbers where there is 
akes 

memory space just as the whole number portion, the range of numbers 
possible in a float is therefore decreased compared to non-floating-point 
numbers. So, unless our variable will definitely use the extra precision, float 
would not be our data type of choice. 

• double: When the precision in float is not enough we have double. 

• short: When even an int data type is overkill, the super-skinny short fits 
into the tiniest of storage boxes, but we can only store around 64,000 values, 
from -32,768 to 32,767. 

• byte of 

27. 

• boolean: We will be using plenty of Booleans throughout the book. 

Booleans answer questions such as: 

° Is the player alive? 

0 Has a new high score been reached? 

0 Are two examples for a Boolean variable enough? 

• char: This stores a single alphanumeric character. It's not going to change 
anything on its own but it could be useful if we put lots of them together. 


I have kept this discussion of data types to a practical level that is 



type's value is stored and why the limits are what they are, visit the 
Oracle Java tutorials site at http : //docs . oracle . com/ j avase/ 
tutorial/java/nutsandbolts/datatypes . html. Note 
that you do not need any more information than we have already 
discussed to continue with this book. 
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equire a 

specific amount of memory. So we must let the Java compiler know the type of 
the variable before we begin to use it. 


The preceding variables are known as the primitive types. They use predefined 
amounts of memory and so, using our storage analogy, fit into predefined sizes of 
the storage box. 

reference types. 

Reference types 

You might have noticed that we didn't cover the string variable type that we 
previously used to introduce the concept of variables. 

uite simply 

refer to a place in memory where the storage of the variable begins, but the reference 
type itself does not define a specific amount of memory. The reason for this is fairly 
ed until 

the program is actually run. 
ng and 

contracting storage boxes. So won't one of these string reference types bump 
into another variable eventually? If you think about the devices memory as a huge 
the Dalvik 

virtual machine as a super-efficient forklift truck driver that puts the different types 
of storage boxes in the most appropriate place. 

around in 

a fraction of a second to avoid collisions. It will even incinerate unwanted storage 
ading new 

storage boxes of all types and placing them in the best place, for that type of variable, 
is different 
s about this in 

Chapter 6, OOP - Using Other People's Hard Work. 

So strings can be used to store any keyboard character, like a char data type but of 
almost any length. Anything from a player's name to an entire book can be stored in 
a single string. We will be using strings regularly including in this chapter. 

y to store 

lots of variables of the same type, ready for quick and efficient access. We will look 
at arrays in Chapter 5, Gaming and Java Essentials. 
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a certain type 
these in the 

same part of the warehouse as strings, 
look at in 

Chapter 6, OOP - Using Other People's Hard Work. 

So we know that each type of data that we might want to store will require an 
the 

variable before we begin to use it. 


Declaration 

es and 

types. Remember that each primitive type requires a specific amount of real device 
memory. This is one of the reasons that the compiler needs to know what type a 
variable will be of. So we must first declare a variable and its type before we attempt 
to do anything with it. 

To declare a variable of type int with the name score, we would type: 
int score; 

That's it! Simply state the type, in this case int, then leave a space, and type the 
nd of the 
hat follows, 

if anything, is not part of the declaration. 

same way. 
eserving 

a labeled storage box in the warehouse: 

long millisecondsElapsed; 
float gravity; 
double accurateGravity ; 
boolean isAlive; 
char playerlnitial ; 

String playerName; 


Initialization 

Here, for each type, we initialize a value to the variable. Think about placing a value 
inside the storage box, as shown in the following code: 

score = 0; 

millisecondsElapsed = 1406879842000 ; //1st Aug 2014 08:57:22 
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gravity = 1.256; 

double accurateGravity =1.256098; 
isAlive = true; 
playerlnitial = ' C'; 
playerName = "Charles Babbage"; 

Notice that the char variable uses single quotes ( ' ) around the initialized value while 
the string uses double quotes ("). 

lowing snippet 
ly, but in one 
step each: 

int score = 0; 

long millisecondsElapsed = 1406879842000 ; //1st Aug 2014 08:57:22 

float gravity = 1.256; 

double accurateGravity =1.256098; 

boolean isAlive = true; 

char playerlnitial = ' C'; 

String playerName = "Charles Babbage"; 



Whether we declare and initialize separately or together is probably 
dependent upon the specific situation. The important thing is that we 
must do both: 
int a; 

//The line below attempts to output a to the console 
Log . i (" info" , "int a = " + a) ; 

The preceding code would cause the following result: 

Compiler Error: Variable a might not have been 
initialized 

There is a significant exception to this rule. Under certain 
circumstances variables can have default values. We will see this in 
Chapter 6, OOP - Using Other People's Hard Work. But it is good practice 
to both declare and initialize variables. 
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Changing variables with operators 

ith these 

values. Here is a list of perhaps the most common Java operators that allow us to 
t every 

line of code when we use them for the first time: 

• The assignment operator (=): This makes the variable to the left of the 
operator the same as the value to the right. For example, hiscore = score ; 
or score = 100 ; . 

• The addition operator (+): This adds the values on either side of the 
/ 

such as score = aliensShot + wavesCleared; or score = score 
+ 100 ; . Notice that it is perfectly acceptable to use the same variable 
simultaneously on both sides of an operator. 

• The subtraction operator (-): This subtracts the value on the right side of the 
ith the 

assignment operator, such as lives = lives - 1; or balance = income - 
outgoings ; . 

• The division operator (/): This divides the number on the left by the number 
nt 

operator, as shown in fairShare = numSweets / numChildren; or 
recycledValueOf Block = originalValue / .9;. 

• The multiplication operator (*): This multiplies variables and numbers, such 

as answer = 10 * 10; or biggerAnswer = 10 * 10 * 10;. 

• The increment operator (++): This is a really neat way to add l to the value 
of a variable. The myVariable = myVariable + 1; statement is the same 
as myVariable++ ; . 

• The decrement operator You guessed it: a really neat way to subtract l 
from something. The myVariable = myVariable - 1 ; statement is the same 
as myVariable- - ; . 



The formal names for these operators are slightly different from the 
names used here for explanation. For example, the division operator 
is actually one of the multiplicative operators. But the preceding 
names are far more useful for the purpose of learning Java and if you 
used the term "division operator", while conversing with someone 
from the Java community, they would know exactly what you mean. 
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bunch later in this chapter when we learn about decisions in Java. 
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If you are curious about operators there is a complete list of them 
on the Java website at http : //docs . oracle . com/ j avase/ 
tutorial / j ava/nutsandbolts /operators . html. All the 
operators required to complete the projects in this book will be fully 
explained in this book. The link is provided for the curious among us. 


Expressing yourself in Java 

Let's try using some declarations, assignments and operators. When we bundle 
ssion. 

So let's write a quick app to try some out. 

e have 
the previous 

chapter but we will not need a UI this time. 

Instead, we will simply write some Java code and examine its effects by outputting 
the values of variables to the Android console, called logcat. We will see exactly 
the 

console output: 

The following is a quick reminder of how to create a new project. 

1. Close any currently open projects by navigating to File | Close Project. 

2. Click on Start a new Android Studio project. 

3. The Create New Project configuration window will appear. Fill in the 
Application name field and Company Domain with packtpub . com 
or you could use your own company website name here instead. 

4. Now click on the Next button. On the next screen, make sure the Phone and 
Tablet checkbox has a tick in it. Now we have to choose the earliest version 
of Android we want to build our app for. Go ahead and play with a few 
sion 

wer 
nee 

is to select API 8: Android 2.2 (Froyo). 
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5. Click on Next. Now select Blank Activity and click on Next again. 

6. On the next screen, simply change Activity Name to MainActivity and click 

on Finish. 

7. As we did in Chapter 2, Getting Started with Android, to keep our code clear and 
simple, you can delete the two unneeded methods (onCreateOptionsMenu 
and onOptionsItemSelected) and their associated @override and @import 
statements. However, this is not necessary for the example to work. 

For a detailed explanation and images of creating a 
new project, see Chapter 2, Getting Started with Android. 

ew the code 

from the download bundle. You will find the code for this tutorial in the Chapter3/ 
ExpressionslnJava/MainActivity . java file. Just create the project as described 
previously and paste the code from MainActivity . j ava file from the download 
bundle to the MainActivity . j ava file that was generated when you created the 
as the one 

you chose when the project was created. However, I strongly recommend going 
rselves. 




As this app uses the logcat console to show its output, you should 
run this app on the emulator only and not on a real Android device. 
The app will not harm a real device, but you just won't be able to see 
anything happening. 


1. Create a new blank project called Expressions In Java. 

2. Now, in the onCreate method just after the line where we use the 
setContentview method, add this code to declare and initialize 
some variables: 

//first we declare and initialize a few variables 
int a = 10; 

String b = "Alan Turing"; 
boolean c = true; 
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3. Now add the following code. This code simply outputs the value of our 
variables in a form where we can closely examine them in a minute: 

//Let's look at how Android 'sees' these variables 

//by outputting them, one at a time to the console 
Log . i ( " inf o" , "a = " + a); 

Log . i ( " inf o" , "b = " + b); 

Log . i ( " inf o" , "c = " + c) ; 

4. Now let's change our variables using the addition operator and another new 
operator. See if you can work out the output values for variables a, b, and c 
before looking at the output and the code explanation: 

//Now let's make some changes 
a++ ; 

a = a + 1 0 ; 

b = b + " was smarter than the average bear Booboo"; 
b = b + a ; 

c = (1 + 1 == 3 ) ; / / 1 + 1 is definitely 2! So false. 

5. Let's output the values once more in the same way we did in step 3, but this 
time, the output should be different: 

//Now to output them all again 
Log . i (" info" , "a = " + a); 

Log . i (" info" , "b = " + b) ; 

Log . i ( " inf o" , "c = " + c) ; 

6. Run the program on an emulator in the usual way. You can see the output 
by clicking on the Android tab from our "useful tabs" area below the 
Project Explorer. 

info: a = 10 
info: b = Alan Turing 
info: c = true 
info: a = 21 

info: b = Alan Turing was smarter than the average bear Booboo21 
info: c = false 
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Now let's discuss what happened. In step 2, we declared and initialized three variables: 

• a: This is an int that holds the value 10 

• b 

• c: This is a Boolean that holds the value false 


get 

the following: 

info: a = 10 

info: b = Alan Turing 

info: c = true 

In step 4, all the fun stuff happens. We add 1 to the value of our int a using the 
increment operator like this: a++ ; . Remember that a++ is the same as a = a + i. 

We then add 10 to a. Note we are adding 10 to a after having already added 1. So we 
get this output for a 10 + 1 + 10 operation: 

info: a = 21 

Now let's examine our string, b. We appear to be using the addition operator on 
s. We are 

adding together two strings "Alan Turing" and "was smarter than the average 
bear Booboo . " When you add two strings together it is called concatenating and 
the + symbol doubles as the concatenation operator. 

Finally, for our string, we appear to be adding int a to it. This is allowed and the 
value of a is concatenated to the end of b. 

info: b = Alan Turing was smarter than the average bear Booboo21 



This does not work the other way round; you cannot add a string 
to an int. This makes sense as there is no logical answer, 
a = a + b 


a = a + b ; 

/WWVW^^vVWvVWWWVWv^V^vV , 



Incompatible types. 
Required: int 

Found: java. lang. String 
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Finally, let's look at the code that changes our Boolean, c, from true to false: c = 

( 1 + 1 = 3 ) ; . Here, we are assigning to c the value of the expression contained within 
the brackets. This would be straightforward, but why the double equals (==)? We 
have jumped ahead of ourselves a little. The double equals sign is another operator 
called the comparison operator. 

So we are really asking, does 1+1 equal 3? Clearly the answer is false. You might ask, 
"why use == instead of =?" Simply to make it clear to the compiler when we mean to 
assign and when we mean to compare. 



Inadvertently using = instead of == is a very common error. 

The assignment operator (=) assigns the value on the right to the 
value on the left, while the comparison operator (==) compares the 
values on either side. 

The compiler will warn us with an error when we do this but at 
first glance you might swear the compiler is wrong. We will learn 
more on this comparison operator and others later in the chapter 
and throughout the book. 


Now let's use everything we know and a bit more to make our math game project. 


Math game - asking a question 

prove 
tual game 
gner to lay 
es, types, 
game 

generate a question for the player. We can then link the start menu and game 
screens together with a push button. 

If you want to save typing and just review the finished project, you can use the code 
downloaded from the Packt Publishing website. If you have any trouble getting any 
of the code to work, you can review, compare, or copy and paste the code from the 
already completed code provided in the download bundle. 

The completed code is in the following files that correspond to the filenames we will 
be using in this tutorial: 

• Chapter3/MathGameChapter3a/ j ava/MainActivity . java 

• Chapter3 /MathGameChapter3a/ j ava/GameActivity . j ava 

• Chapter3/MathGameChapter3 a/ layout/ activity_main . xml 

• Chapter3 /MathGameChapter3a/layout/ activity_game . xml 


[ 71 ] 


Speaking Java - Your First Game 


As usual, I recommend following this tutorial to see how we can create all of the 
code for ourselves. 

Creating the new game activity 

We will first need to create a new Java file for the game activity code and a related 
layout file to hold the game activity UI. 

1. Run Android Studio and select your Math Game Chapter 2 project that we 
built in Chapter 2, Getting Started with Android. It might have been opened by 
he 

actual game screen, which will run when the player taps the Play button on 
our main menu screen. 

2. To create a new activity, we now need another layout file and another Java 
fi 

creating all the files we need for a new activity, right-click on the src folder 
in the Project Explorer and then go to New | Activity. Now click on Blank 
Activity and then on Next. 

3. We now need to tell Android Studio a little bit about our new activity by 
entering information in the above dialog box. Change the Activity Name 
field to GameActivity. Notice how the Layout Name field is automatically 
changed for us to activity_game and the Title field is automatically 
changed to GameActivity. 

4. Click on Finish. Android Studio has created two files for us and has also 
registered our new activity in a manifest file, so we don't need to concern 
ourselves with it. 

5. If you look at the tabs at the top of the editor window, you will see that 
GameActivity . j ava has been opened up ready for us to edit, as shown 
in the following screenshot: 


c MainActivity.java x 


c GameActivity. java x 


activity_main.xml x 


6. Ensure that GameActivity . j ava is active in the editor window by clicking 
on the GameActivity .java tab shown previously. 
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7. Back in Chapter 2, Getting Started with Android, we talked about how Android 
overrides some methods for us by default, and that most of them were not 
move 

it, then it will make our working environment simpler and cleaner. You 
might also remember from Chapter 2, Getting Started with Android, that the 
process of deleting and amending sections of code, although not complex, 
is a fairly long process. To avoid this here, we will simply use the code from 
MainActivity . j ava as a template for GameActivity . j ava. We can then 
make some minor changes. 

8. Click on the MainActivity .java tab in the editor window. Highlight all of the 
code in the editor window using Ctrl + A on the keyboard. 

9. Now copy all of the code in the editor window using the Ctrl + C on 
the keyboard. 

10. Now click on the GameActivity .java tab. 

11. Highlight all of the code in the editor window using Ctrl + A on 
the keyboard. 

12. Now paste the copied code and overwrite the currently highlighted code 
using Ctrl + V on the keyboard. 

13. Notice that there is an error in our code denoted by the red underlining 
as shown in the following screenshot. This is because we pasted the code 
referring to MainActivity in our file that is called GameActivity. 


package com.packtpub.mathgamechapter2a .mathgamechapter2a; 

import . . . 


publi c class KainAckiyllX. extends AgUylty 

{ 

@Override 


protected void onCreate (Bundle savedlnstanceState) { 

super. onCreate (savedlnstanceState) ; 


setContentView (R. layout . activity main ) ; 

1 

1 



Simply change the text MainActivity to GameActivity and the error will 
disappear. Take a moment to see if you can work out what other minor 
change is necessary, before I tell you. 
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14. Remember that setContentview loads our UI design. Well what we need 
to do is change setContentview to load the new design (that we will build 
next) instead of the home screen design. Change setContentview (R . layout . 
activity_main) ; to setContentview (R . layout . activity_game) ;. 

15. Save your work and we are ready to move on. 

Note the Project Explorer where Android Studio puts the two new files it created for 
will simply refer 

to them as our j ava code folder or layout files folder. 


O src 
T E] main 


El java 

E l com.packtpub.mathqa mechapter2a.mathqamechapter2a 


c, GameActivity 
c 'b MainActivity 


C# res 


B drawable-hdpi 
E] drawable-mdpi 
E] drawable-xhdpi 
Q drawable-xxhdpi 
E] layout 


E] menu 
E] values 
B values-w 820 dp 


<> AndroidManifest.xml 


Our Java code files 


■■ activity_game.xml 

r% . . 

■ activity_main.xml 


Our UI layout files 



You might wonder why we didn't simply copy and paste the 
MainActivity . j ava file to begin with and saved going through 
the process of creating a new activity? The reason is that Android 
Studio does things behind the scenes. Firstly, it makes the layout 
template for us. It also registers the new activity for use through 
a file we will see later, called AndroidManif est . xml. This is 
necessary for the new activity to be able to work in the first place. 
All things considered, the way we did it is probably the quickest. 
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screen. 

We state the package name and import some useful classes provided by Android: 
package com . packtpub . mathgamechapter3a . mathgamechapter3a ; 


import android . app . Activity; 
import android . os . Bundle ; 

We create a new activity, this time called GameActivity: 

public class GameActivity extends Activity { 

Then we override the onCreate method and use the setContentView method 

however, 

this UI is empty: 

super . onCreate ( savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

We can now think about the layout of our actual game screen. 

Laying out the game screen UI 

As we know, our math game will ask questions and offer the player some multiple 
choices to choose answers from. There are lots of extra features we could add, such as 
difficulty levels, high scores, and much more. But for now, let's just stick to asking a 
simple, predefined question and offering a choice of three predefined possible answers. 

Keeping the UI design to the bare minimum suggests a layout. Our target UI will 
look somewhat like this: 



2x2 


b ei a 
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The layout is hopefully self-explanatory, but let's ensure that we are really clear; when 
we come to building this layout in Android Studio, the section in the mock-up that 
displays 2 x 2 is the question and will be made up of three text views (both numbers, 
and the = sign is also a separate view). Finally, the three options for the answer are 
made up of Button layout elements. We used all of these UI elements in the previous 
chapter, but this time, as we are going to be controlling them using our Java code, there 
are a few extra things we need to do to them. So let's go through it step by step: 

1. Open the file that will hold our game UI in the editor window. Do this by 
double-clicking on activity_game . xml. This is located in our UI layout 
folder, which can be found in the project explorer. 

2. Delete the Hello World TextView, as it is not required. 

3. Find the Large Text element on the palette. It can be found under the 
Widgets section. Drag three elements onto the UI design area and arrange 
not 

have to be exact; just ensure that they are in a row and not overlapping, as 
shown in the following screenshot: 



4. Notice in the Component Tree window that each of the three TextViews has 
been assigned a name automatically by Android Studio. They are textView , 
textView2, and textView3: 


Component Tree 
▼ CV Device Screen 
’ E RelativeLayout 

Large Text" 
"Large Text" 
"Large Text" 



textView 

m 

textView2 

lAg 

textView3 
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5. Android Studio refers to these element names as an id. This is an important 
concept that we will be making use of. So to confirm this, select any one of 
the textViews by clicking on its name (id), either in the component tree as 
hown 

previously. Now look at the Properties window and find the id property. 
You might need to scroll a little to do this: 



Notice that the value for the id property is textView. It is this id that we will 
the 

IDs of our TextViews to something useful and easy to remember. 

6. If you look back at our design, you will see that the UI element with the 
textView id is going to hold the number for the first part of our math 
question. So change the id to textPartA. Notice the lowercase t in text, the 
uppercase P in Part, and the uppercase A. You can use any combination of 
ith 

1 

make things less error-prone as our program gets more complicated. 

7. Now select textView2 and change id to textOperator. 

8. Select the element currently with id textView3 and change it to textPartB. 
This TextView will hold the later part of our question. 

9. Now add another Large Text from the palette. Place it after the row of the 
three TextViews that we have just been editing. 

This Large Text will simply hold our equals to sign and there is no plan to 
e don't 
s. 

edit 
its ID. 

10. However, this new TextView currently displays Large Text and we want 
it to display an equals to sign. So in the Properties window, find the text 
property and enter the value =. We have changed the text property before 
in Chapter 2, Getting Started with Android, and you might also like to change 
the text property for textPartA, textPartB, and textOperator. This is 
ia 

our Java code; however, if we change the text property to something more 
ame 

runs on a real device. 
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11 . So change the text property of textPartA to 2, textPartB to 2, and textOperator 
to x. Your UI design and Component tree should now look like this: 


f»Nexuj4- Pi - (|)Th€me Game Activity » 

en 0 ta Ha a a 0 0 



Component Tree 
▼ a Device Screen 
W [Kj RelativeLayout 

^ textPartA (TextView) 2" 
SI textOperator (TextView) 
SI textPartB (TextView) 

Si textV»ew4 


12. For the buttons to contain our multiple choice answers, drag three buttons in 
a row, below the = sign. Line them up neatly like our target design. 

13. Now, just as we did for the TextViews, find the id properties of each 
button, and from left to right, change the id properties to buttonChoicel, 
buttonChoice2, and buttonChoice3. 

14. Why not enter some arbitrary numbers for the text property of each button so 
that the designer more accurately reflects what our game will look like, just 
al as 

our Java code will control the button appearance. 

15. We are now actually ready to move on. But you probably agree that the UI 
elements look a little lost. It would look better if the buttons and text were 
iew 

and for each Button. Then, we just need to find the textSize property for 
each element and enter a number with the sp syntax. If you want your 
design to look just like our target design from earlier, enter 7 o sp for each of 
the TextView textSize properties and 4 0sp for each of the Buttons textSize 

to 

do before we can actually try out our game. 

16. Save the project and then we can move on. 
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he important 
e we are now 

able to communicate with our UI through our Java code. 

Coding a question in Java 

With our current knowledge of Java, we are not yet able to complete our math game 
but we can make a significant start. We will look at how we can ask the player a 
question and offer them some multiple choice answers (one correct and two incorrect). 

iables that 

times tables 

question 2 x 2 s 

for each part of the question: 

int partA = 2 ; 
int partB = 2 ; 

The preceding code declares and initializes two variables of the int type, each to the 
value of 2. We use int because we will not be dealing with any decimal fractions. 
Remember that the variable names are arbitrary and were just chosen because they 
need to 

ask more varied and advanced questions than 2x2, but it is a start, 
o, we 

ct answers. 

Take a look at these combined declarations and initializations: 

int correctAnswer = partA * partB; 
int wrongAnswerl = correctAnswer - 1; 
int wrongAnswer2 = correctAnswer + 1; 

Note that the initialization of the variables for the wrong answers depends on the 
initialized 

after initializing the correctAnswer variable. 
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Now we need to put these values, held in our variables, into the appropriate elements 
on our UI. The question variables (partA and partB) need to be displayed in our UI 
elements, textPartA and textPartB, and the answer variables (correctAnswer, 
wrongAnswerl, and wrongAnswer2) need to be displayed in our UI elements with the 
following IDs: buttonChoicel, buttonChoice2, and buttonChoice3. We will see 
how we do this in the next step-by-step tutorial. We will also implement the variable 
declaration and initialization code that we discussed a moment ago: 

1. First, open GameActivity . j ava in the editor window. Remember that 
you can do this by double-clicking on GameActivity in our j ava folder 
or clicking on its tab above the editor window if GameActivity . j ava is 
already open. 

2. All of our code will go into the onCreate method. It will go after the 
setContentView (R . layout . activity_game) ; line but before the closing 
curly brace } of the onCreate method. Perhaps, it's a good idea to leave 

following code. We can see the entire onCreate method as it stands after the 
to 

add helpful comments like mine if you wish: 

@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate ( savedlnstanceState) ; 

//The next line loads our UI design to the screen 
setContentView (R . layout . activity_game) ; 

//Here we initialize all our variables 
int partA = 9 ; 
int partB = 9 ; 

int correctAnswer = partA * partB; 
int wrongAnswerl = correctAnswer - 1; 
int wrongAnswer2 = correctAnswer + 1; 

}/ /onCreate ends here 
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3. Now we need to add the values contained within the variables to the 
Textview and Button of our UI. But first, we need to get access to the UI 
elements we created. We do that by creating a variable of the appropriate 
We 

already know the class of our UI elements: Textview and Button. Here is 
the code that creates our special class variables for each of the necessary 
UI elements. Take a close look at the code, but don't worry if you don't 
hing 

is working. Enter the code immediately after the code entered in the 
previous step. You can leave a blank line for clarity if you wish. Just before 
you proceed, note that at two points while typing in this code, you will be 
prompted to import another class. Go ahead and do so on both occasions: 
/*Here we get a working object based on either the button 
or Textview class and base as well as link our new objects 
directly to the appropriate UI elements that we created 
previously*/ 


Textview textObj ectPartA = 

(Textview) f indViewByld (R . id . text Part A) ; 


Textview textObj ectPartB = 

(Textview) f indViewByld (R . id . textPartB) ; 


Button buttonObj ectChoicel = 

(Button) f indViewByld (R . id . buttonChoicel ) ; 


Button buttonObj ectChoice2 = 

(Button) f indViewByld (R . id . buttonChoice2 ) ; 


Button buttonObj ectChoice3 = 

(Button) f indViewByld (R . id . buttonChoice3 ) ; 



In the preceding code, if you read the multiline comment, you 
will see that I used the term object. When we create a variable 
type based on a class, we call it an object. Once we have an object 
of a class, we can do anything that that class was designed to do. 
This is very powerful and is explored thoroughly in Chapter 6, 
OOP - Using Other People's Hard Work. 
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4. Now we have five new objects linked to the elements of our UI that we need 
to manipulate. What precisely are we going to do with them? We need to 
an use 

/ 

this 

ctly after 
we 

look at it together: 

//Now we use the setText method of the class on our objects 
//to show our variable values on the UI elements. 

//Just like when we output to the console in the exercise - 
//Expressions in Java, only now we use setText method 
//to put the values in our variables onto the actual UI . 
textObj ectPartA . setText (" " + partA); 
textObj ectPartB . setText (" " + partB); 

//which button receives which answer, at this stage is arbitrary. 

buttonObj ectChoicel . setText (" " + correctAnswer) ; 
buttonObj ectChoice2 . setText (" " + wrongAnswerl); 
buttonObj ectChoice3 . setText ( " " + wrongAnswer2 ) ; 

5. Save your work. 

If you play with the assignment values for partA and partB, you can make them 
y, we 
d we 

tion we have 

1 . 

In step 2, we declared and initialized the variables required so far: 

//Here we initialize all our variables 
int partA = 2 ; 
int partB = 2 ; 

int correctAnswer = partA * partB; 
int wrongAnswerl = correctAnswer - 1 ; 
int wrongAnswer2 = correctAnswer + 1 ; 

e. For the 

TextViews, it was done like this: 

TextView textObj ectPartA = (TextView) findViewByld (R . id . textPartA) ; 
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this: 

Button buttonObj ectChoicel = 

Button) f indViewByld (R . id . buttonChoicel) ; 

In step 4, we did something new. We used a the setText method to show the 
values of our variables on our UI elements (Textview and Button) to the player, 
de that 

shows the correctAnswer variable being displayed on buttonObj ectChoicel. 

buttonObj ectChoicel . setText (" " + correctAnswer); 

By typing buttonObj ectChoicel and adding a period, as shown in the following 
line of code, we have access to all the preprogrammed methods of that object's class 
type that are provided by Android: 

buttonObj ectChoicel . 


The power of Button and the Android API 

There are actually lots of methods that we can perform on an object of 
the Button type. If you are feeling brave, try this to get a feeling of just 
how much functionality there is in Android. 

Type the following code: 
buttonObj ectChoicel . 



of possible methods to use on this object. Scroll through the list and get 
a feel of the number and variety of options: 


//to show our var 

m setBackgroundResource (int resid) 

void 

textObjectPartA. s< 
textOb j ectPartB . s( 

b setBackground (Drawable background) 

& setText ( char [ ] text, int start, int 

void 

.. void 

»•'*» equals (Object o) 

boolean 

//which button re 

setVisibility ( int visibility) 

void 


1 onlnitializeAccessibilityEvent (Acces 

.. void 

buttonObj ectChoice 

m onlnitializeAccessibili tyNodelnfo (Ac 

.. void 

buttonObj ectChoici 

® ° addChildrenForAccessibility (ArrayLis 

.. void 

buttonObj ectChoic< 

if" addFocusables (ArrayList<View> views, 

.. void 


® *> addFocusables (ArrayList<View> views, 

.. void 


Ctrl* Down and Ctrl. Up w* move caret down and up in the editor > » 

[7C] 

buttonObj ectChoicel .[_ 


} //onCreate ends here 




games once we have mastered all the classes contained in Android. A 
collection of classes designed to be used by others is collectively known 

as an Application Programmers Interface (API). Welcome to the 
Android API! 
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In this case, we just want to set the button's text. So, we use setText and concatenate 
the value stored in our correctAnswer variable to the end of an empty string, like this: 

setText (" " + correctAnswer); 


Playing with autocomplete 

If you tried the previous tip. The power of Button and the Android API, and 



already have some insight into autocomplete. Note that as you type. 
Android Studio is constantly making suggestions for what you might 
like to type next. If you pay attention to this, you can save a lot of time. 
Simply select the correct code completion statement that is suggested 
and press Enter. You can even see how much time you saved by selecting 
Help | Productivity Guide from the menu bar. Here you will see 
statistics for every aspect of code completion and more. Here are a few 
entries from mine: 


Finish lookup even when non-focused 

Code Completion 

1,281 times 

Basic code completion 

Code Completion 

1,847 times 

Variable name completion 

Code Completion 

2,131 times 


e 

a lot of time in the long run. 


Linking our game from the main menu 

At the moment, if we run the app, we have no way for the player to actually arrive at 
our new game activity. We want the game activity to run when the player clicks on 
the Play button on the main MainActivity UI. Here is what we need to do to make 
that happen: 

1. Open the file activity_main . xml, either by double-clicking on it in the 
Project Explorer or by clicking on its tab in the editor window. 

2. Now, just like we did when building the game UI, assign an ID to the Play 
button. As a reminder, click on the Play button either on the UI design 

or in the component tree. Find the id property in the Properties window. 
Assign the buttonPlay value to it. We can now make this button do stuff by 
referring to it in our Java code. 

3. Open the file MainActivity . j ava, either by double-clicking on it in the 
Project Explorer or clicking on its tab in the editor window. 
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4. In our onCreate method, just after the line where we setContentview, add 
the following highlighted line of code: 

setContentview (R . layout . activity_main) ; 

Button buttonPlay = (Button) findViewByld (R. id. buttonPlay) ; 

5. We will dissect this code in detail once we have got this working. Basically 
we are making a connection to the Play button by creating a reference 
variable to a Button object. Notice that both words are highlighted in red 
indicating an error. Just as before, we need to import the Button class to make 
this code work. Use the Alt + Enter keyboard combination. Now click on 
Import class from the popped-up list of options. This will automatically add 
the required import directive at the top of our MainActivity . java file. 

6. Now for something new. We will give the button the ability to listen to the user 
clicking on it. Type this immediately after the last line of code we entered: 
buttonPlay. setOnClickListener (this) ; 

7. Notice how the this keyword is highlighted in red indicating an error, 
ed 

in Chapter 6, OOP - Using Other People's Hard Work. Setting that aside, we 
need to make a modification to our code now in order to allow the use of an 
nality, 
pted to 

import another class, click on OK: 

public class MainActivity extends Activity { 

to 

public class MainActivity extends Activity implements View. 
OnClickListener { 


but it's where we should be at this point. We mentioned that by adding 
implements View. OnClickListener, we have implemented an interface. 
We can think of this like a class that we can use but with extra rules. The 
rules of the OnClickListener interface state that we must implement/use 
one of its methods. Notice that until now, we have optionally overridden/ 
used methods as and when they have suited us. If we wish to use the 
es, 

then we have to add/implement the onClick method. 
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8. This is how we do it. Notice the opening curly brace, {, and the closing 

curly brace, } . These denote the start and end of the method. Notice that the 
h 

to comply with the rules of the OnClickListener interface, and the red line 

ods 

hen 

code, outside the closing curly brace (}) of the onCreate method but inside 
the closing curly brace of our MainActivity class: 

©Override 

public void onClick(View view) { 


9. Notice that we have an empty line between { and } of the onClick method. 
We can now add code in here to make the button actually do something. 
Type the following highlighted code between { and } of onClick: 

©Override 

public void onClick (View view) { 

Intent i; 

i = new Intent(this, GameActivity. class) ; 
startActivity (i) ; 

} 

10. OK, so that code is a bit of a mouthful to comprehend all at once. See 
if you can guess what is happening. The clue is in the method named 
startActivity and the hopefully familiar term, GameActivity. Notice that 
we are assigning something to i. We will quickly get our app working and 
we 

explore how classes work in Chapter 6, OOP - Using Other People's Hard Work. 

11. Notice that we have an error: all instances of the word intent are red. We 
can solve this by importing the classes required to make intent work. As 
before press Alt + Enter. 

12. Run the game in the emulator or on your device. 
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pressing 

Play on the menu screen: 



ot to it as 

well. Let's go over the contents of MainActivity . j ava and look at it line by line. 
For context, here it is in full: 

package com . packtpub . mathgamechapter3a . mathgamechapter3a ; 

import android . app . Activity; 
import android . content . Intent ; 
import android . os . Bundle ; 
import android . view . View; 
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import android . widget . Button; 


public class MainActivity extends Activity implements View. 
OnClickListener { 

©Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate ( savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 
final Button buttonPlay = 

(Button) f indViewByld (R . id . buttonPlay) ; 
buttonPlay. setOnClickListener (this) ; 

} 


©Override 

public void onClick(View view) { 

Intent i ; 

i = new Intent (this, GameActivity . class ) ; 
startActivity ( i ) ; 

} 


at a time 
s: 


package com . packtpub . mathgamechapter3a . mathgamechapter3a ; 

import android . app . Activity; 
import android . content . Intent ; 
import android . os . Bundle ; 
import android . view . View; 
import android . widget . Button; 

You would probably remember that this first block of code defines what our package 
is called and makes available all the Android API stuff we need for Button, TextView, 
and Activity. 

From our MainActivity . j ava file, we have this: 

public class MainActivity extends Activity implements View. 
OnClickListener { 

Our MainActivity declaration with our new bit of code implements view . 
OnClickListener that gives us the ability to detect button clicks. 
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Next in our code is this: 

©Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 
setContentView (R . layout . activity_main) ; 

This previous bit of code hasn't changed since Chapter 2, Getting Started with Android. 
It is at the start of our onCreate method where we first ask the hidden code of 
onCreate to do its stuff using super . onCreate (savedlnstanceState) ; . Then we 
set our UI to the screen with setContentView (R . layout . activity_main) ; . 

Next, we get a reference to our button with an ID of buttonPlay: 

Button buttonPlay = (Button) findViewByld (R . id . buttonPlay) ; 
buttonPlay. setOnClickListener (this) ; 

Finally, our onClick method uses the intent class to send the player to our 
GameActivity class and the related UI when the user clicks on the Play button: 

©Override 

public void onClick(View view) { 

Intent i ; 

i = new Intent (this, GameActivity . class ) ; 
startActivity (i) ; 

} 

If you run the app, you will notice that we can now click on the Play button and our 
hough we 

have very briefly looked at how to deal with button presses, we need to learn more 
to write code 

to handle presses from several buttons. This will be necessary to receive input from 
our multiple-choice-centric game_activity UI. 


Decisions in Java 

We can now summon enough of Java prowess to ask a question but a real math game 
nswer, 

and we are nearly there with that— we can detect button presses. From there, we 
need to be able to decide whether their answer is right or wrong. Then, based on this 
decision, we have to choose an appropriate course of action. 

us by 

learning some more fundamentals and syntax of the Java language. 
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More operators 

Let's look at some more operators: we can already add (+), take away (-), multiply 
(*), divide (/), assign (=), increment (++), compare (==), and decrement (-- ) with 
operators. Let's introduce some more super-useful operators, and then we will go 
straight to actually understanding how to use them in Java. 



Don't worry about memorizing every operator given here. Glance 
at them and their explanations and then move quickly on to the 
next section. There, we will put some operators to use and they will 
become much clearer as we see a few examples of what they allow 
us to do. They are presented here in a list just to make the variety 
and scope of operators plain from the start. The list will also be 
more convenient to refer back to when not intermingled with the 
discussion about implementation that follows it. 


• ==: This is a comparison operator we saw this very briefly before. It tests 
for equality and is either true or false. An expression like ( l o = = 9 ) ; , for 
example, is false. 

• ! : The logical NOT operator. The expression, ! (2+2==5).),is true because 
2+2 is NOT 5. 

• !=: This is another comparison operator, which tests if something is NOT 
equal. For example, the expression, ( l o ! = 9 ) ; ) , is true, that is, 10 is not 
equal to 9. 

• >: This is another comparison operator, which tests if something is greater 
than something else. The expression, ( l o > 9 ) ; ) , is true. There are a few 
more comparison operators as well. 

• <the 

value to the right or not. The expression, ( l o < 9 ) ; , is false. 

• >= 

other, and if either is true, the result is true. For example, the expression, ( l o 
>= 9 );, is true. The expression, ( l o >= 10) ;, is also true. 

• <=t 

this time, less than and equal to. The expression, ( l o < = 9 ) ; , is false. The 
expression, do <= 10) ;, is true. 

• &&: This operator is known as logical AND. It tests two or more separate 
parts of an expression and all parts must be true in order for the result to be 
true. Logical AND is usually used in conjunction with the other operators to 
build more complex tests. The expression, (( l o > 9) && do < n));,is 
true because both parts are true. The expression, (do > 9) && (10 < 9));, 
is false because only one part of the expression is true and the other is false. 
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• | | : This operator is called logical OR. It is just like logical AND except 

the 
e the 

&& sign with | | . The expression, ((10 > 9 ) || (10 < 9 ));, is now true 

because one part of the expression is true. 

sing them 
t how to make 
decisions in Java. 

Decision 1 - If they come over the bridge, 
shoot them 

obably 
Now, when 

we look at putting the most common operator, ==, to use, we can start to see the 
powerful yet fine control that operators offer us. 

Let's make the previous examples less abstract using the Java if keyword and a few 
conditional operators with a fun story and some code. 

t very 
s after he 

has died. The troops must hold one side of a bridge while awaiting reinforcements. 

The first command the captain wants to make sure his troops understand is this: If 
they come over the bridge, shoot them. 

So how do we simulate this situation in Java? We need a Boolean variable 
isComingOverBridge. The next bit of code assumes that the isComingOverBridge 
variable has been declared and initialized. 

We can then use it like this: 

if (isComingOverBridge) { 

//Shoot them 

} 


If the isComingOverBridge Boolean is true, the code inside the opening and 
closing curly braces will run. If not, the program continues after the i f block 
without running it. 
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Decision 2 - Else, do this 

enemy is not 
coming over the bridge. 

Now we introduce another Java keyword, else. When we want to explicitly do 
something and the if block does not evaluate to true, we can use else. 

For example, to tell the troops to stay put if the enemy is not coming over the bridge, 
we use else: 

if (isComingOverBridge) { 

/ / Shoot them 
}else{ 

//Hold position 

} 


The captain then realized that the problem wasn't as simple as he first thought. What 
if the enemy comes over the bridge and has more troops? His squad will be overrun. 
So, he came up with this code (we'll use some variables as well this time): 

boolean isComingOverTheBridge; 
int enemyTroops ; 
int f riendlyTroops ; 

//Code that initializes the above variables one way or another 
//Now the if 

if ( isComingOverTheBridge && f riendlyTroops > enemyTroops) { 

/ / shoot them 

}else if ( isComingOverTheBridge && f riendlyTroops < enemyTroops) { 
//blow the bridge 
}else{ 

//Hold position 

} 

bridge 

waving the white flag of surrender and were promptly slaughtered, then his men 
would end up as war criminals. The Java code needed was obvious. Using the 
wavingWhiteFlag Boolean variable he wrote this test: 

if (wavingWhiteFlag) { 

//Take prisoners 

} 


[ 92 ] 



Chapter 3 


for the 

following nested solution and changing the test for wavingWhiteFlag to logical 
NOT, like this: 

if (! wavingWhiteFlag) { //not surrendering so check everything else 
if ( isComingOverTheBridge && f riendlyTroops > enemyTroops) { 

/ / shoot them 

}else if ( isComingOverTheBridge && f riendlyTroops < 
enemyTroops) { 

//blow the bridge 

} 

}else{//this is the else for our first if 
//Take prisoners 

{ 

//Holding position 

This demonstrates that we can nest if and else statements inside of one another to 
create even deeper decisions. 

We could go on making more and more complicated decisions but what we have 
seen is more than sufficient as an introduction. Take the time to reread this if 
anything is unclear. Who knows, there might even be a tricky logic question in the 
self-test at the end of the chapter. It is also important to point out that very often, 
there are two or more ways to arrive at the solution. The right way will usually be 
the way that solves the problem in the clearest and simplest manner. 

Switching to make decisions 

the Java 

operators with if and else statements. But sometimes a decision in Java can be 
better made in other ways. 

When we have to make a decision based on a clear list of possibilities that doesn't 
involve complex combinations, then switch is usually the way to go. 

We start a switch decision like this: 

switch (argument ) { 

} 
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e. Then 
h case 

and break elements: 

case x: 

//code to for x 
break ; 

case y: 

//code for y 
break ; 

suit and 
further 

case statements should be evaluated. The first break encountered takes us out 
of the switch block to proceed with the next line of code. 

We can also use default without a value to run some code if none of the case 
statements evaluate to true, like this: 

def ault : //Look no value 

//Do something here if no other case statements are true 
break ; 

d of game 

where the player types commands such as "Go East", "Go West", "Take Sword", 
and so on. In this case, switch could handle that situation like this example code and 
we could use def ault to handle the case of the player typing a command that is not 
specifically handled: 

//get input from user in a String variable called command 
switch (command) { 

case "Go East" : " : 

//code to go east 
break ; 

case "Go West": 

//code to go west 
break ; 

case "Take sword" : 

//code to take the sword 
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break ; 

//more possible cases 
default : 

/ / Sorry I don ' t understand your command 
break ; 


In the next section, we will use switch so that our ondick method can handle the 
different multiple-choice buttons of our math game. 

Java has even more operators than we have covered here. We 
have looked at all the operators we are going to need in this book 
and probably the most used in general. If you want the complete 
lowdown on operators, take a look at the official Java documentation 
at http : //docs . oracle . com/ j avase/ tutorial/ j ava/ 
nutsandbolts/operators . html. 

Math game - getting and checking the 
answer 

ge 

to the player. Our Java is getting quite good now, so let's dive in and add these 
code 

thoroughly at the end. 

The already completed code is in the download bundle, in the following files 
that correspond to the filenames we will create/ autogenerate in Android Studio 
in a moment: 

• Chapter3/MathGameChapter3b/ java/MainActivity. java 

• Chapter3/MathGameChapter3b/ java/GameActivity. java 

• Chapter3/MathGameChapter3b/layout/activity_main . xml 

• Chapter3/MathGameChapter3b/layout/activity_game . xml 
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As usual, I recommend following this tutorial step by step to see how we can create 
all of the code for ourselves. 

1. Open the GameActivity . j ava file visible in the editor window. 

2. Now we need to add the click detection functionality to our GameActivity, 
just as we did for our MainActivity. However, we will go a little further 
than the last time. So let's do it step by step as if it is totally new. Once again, 
we will give the buttons the ability to listen to the user clicking on them. 

Type this immediately after the last line of code we entered in the onCreate 
method but before the closing } . This time of course, we need to add some 
code to listen to three buttons: 

buttonObjectChoicel . setOnClickListener (this) ; 
buttonObjectChoice2 . setOnClickListener (this) ; 
buttonObjectChoice3 . setOnClickListener (this) ; 

3. Notice how the this keyword is highlighted in red indicating an error. 
Again, we need to make a modification to our code in order to allow the use 
alities 

ted to 

import another class, click on OK. Consider this line of code: 
public class GameActivity extends Activity { 

Change it to the following line: 

public class GameActivity extends Activity implements 
View . OnClickListener { 

4. Now we have the entire preceding line underlined in red. This indicates an 
error but it is where we should be at this point. We mentioned that by adding 
implements View. OnClickListener, we have implemented an interface. 
We can think of this like a class that we can use, but with extra rules. One of 
the rules of the OnClickListener interface is that we must implement one of 
its methods, as you might remember. Now we will add the onClick method. 


[ 96 ] 



Chapter 3 


5. Type the following code. Notice the opening curly brace, {, and the closing 
curly brace, } . These denote the start and end of the method. Notice that the 

comply with the rules of the OnClickListener interface and the red line 
code 

outside the closing curly brace (}) of the onCreate method but inside the 
closing curly brace of our MainActivity class: 

@Override 

public void onClick (View view) { 


} 

6. Notice that we have an empty line between the { and } braces of our onClick 
method. We can now put some code in here to make the buttons actually do 
something. Type the following in between { and } of onClick. This is where 
things get different from our code in MainActivity. We need to differentiate 
between the three possible buttons that could be pressed. We will do this with 
the switch statement that we discussed earlier. Look at the case criteria; they 
should look familiar. Here is the code that uses the switch statements: 
switch (view.getld ( ) ) { 

case R . id . buttonChoicel : 

//button 1 stuff goes here 
break ; 

case R . id . buttonChoice2 : 

//button 2 stuff goes here 
break ; 

case R . id . buttonChoice3 : 

//button 3 stuff goes here 
break ; 

} 
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7. Each case element handles a different button. For each button case, we 
need to get the value stored in the button that was just pressed and see if 
it matches our correctAnswer variable. If it does, we must tell the player 
they got it right, and if not, we must tell them they got it wrong. However, 
there is still one problem we have to solve. The ondick method is separate 
from the onCreate method and the Button objects. In fact, all the variables 
are declared in the onCreate method. If you try typing the code from step 
at 

we need in onClick available in ondick. To do this, we will move their 
declarations from above the onCreate method to just below the opening 
{ of GameActivity. This means that these variables become variables of 
the GameActivity class and can be seen anywhere within GameActivity. 
Declare the following variables like this: 
int correctAnswer; 

Button buttonObj ectChoicel ; 

Button buttonObj ectChoice2 ; 

Button buttonObj ectChoice3 ; 

8. Now change the initialization of these variables within onCreate as follows, 
st is 

shown for context: 

//Here we initialize all our variables 
int partA = 9 ; 
int partB = 9 ; 

correctAnswer = partA * partB; 

int wrongAnswerl = correctAnswer - 1 ; 
int wrongAnswer2 = correctAnswer + 1; 

and 

TextView textObj ectPartA = 

(TextView) f indViewByld (R. id. textPartA) ; 

TextView textObj ectPartB = 

(TextView) f indViewByld (R. id. textPartB) ; 

buttonObj ectChoicel = (Button) findViewByld (R. id. buttonChoicel) ; 

buttonObj ectChoice2 = (Button) findViewByld (R. id. buttonChoice2) ; 

buttonObj ectChoice3 = (Button) findViewByld (R. id. buttonChoice3) ; 
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9. Here is the top of our onClick method as well as the first case statement for 
our onClick method: 

@Override 

public void onClick (View view) { 

//declare a new int to be used in all the cases 
int answerGiven=0 ; 
switch (view. getld ( ) ) { 

case R . id . buttonChoicel : 

//initialize a new int with the value contained in 
buttonOb j ectChoicel 

//Remember we put it there ourselves previously 
answerGiven = Integer . parselnt (" " + 
buttonOb j ectChoicel . getText ( ) ) ; 

//is it the right answer? 

if (answerGiven==correctAnswer) { //yay it's the 
right answer 

Toast .makeText (getApplicationContext ( ) , 

"Well done ! " , 

Toast . LENGTH_LONG ) . show ( ) ; 

}else{//uh oh! 

Toast .makeText (getApplicationContext ( ) , "Sorry 
that's wrong", Toast . LENGTH_LONG) . show () ; 

} 

break ; 

10. Here are the rest of the case statements that do the same steps as the code in 
the previous step except handling the last two buttons. Enter the following 
code after the code entered in the previous step: 

case R . id . buttonChoice2 : 

/ /same as previous case but using the next button 
answerGiven = Integer . parselnt (" " + 
buttonOb j ectChoice2 . getText ( ) ) ; 
if (answerGiven==correctAnswer) { 

Toast .makeText (getApplicationContext ( ) , "Well 
done ! " , Toast . LENGTH_LONG) . show ( ) ; 

}else{ 

Toast .makeText (getApplicationContext ( ) , "Sorry 
that's wrong", Toast . LENGTH_LONG) . show () ; 

} 

break ; 

case R . id . buttonChoice3 : 
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//same as previous case but using the next button 
answerGiven = Integer . parselnt (" " + 
buttonOb j ectChoice3 . getText ( ) ) ; 
if (answerGiven==correctAnswer ) { 

Toast . makeText (getApplicationContext ( ) , "Well 
done ! " , Toast . LENGTH_LONG ) . show ( ) ; 

}else{ 

Toast .makeText (getApplicationContext ( ) , "Sorry 
that's wrong", Toast . LENGTH_LONG) . show (); 


break ; 


11. Run the program, and then we will look at the code carefully, especially 
that odd-looking Toast thing. Here is what happens when we click on 
the leftmost button: 



multi-choice 

buttons, including adding the ability to listen to clicks using the onClick method 
and a switch block to handle decisions depending on the button pressed. 

le in 

the one lick method. We did this by making them member variables of our 
GameActivity class. 
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When we make a variable a member of a class, we call it 
a field. We will discuss exactly when a variable should be 
a field and when it shouldn't in Chapter 6, OOP - Using 
Other People's Hard Work. 

In steps 9 and 10, we implemented the code that actually does the work in our switch 
statement in ondick. Let's take a line-by-line look at the code that runs when buttoni 
is pressed. 

case R . id . buttonChoicel : 

First, the case statement is true when the button with an id of buttonChoicel is 
pressed. Then the next line of code to execute is this: 

answerGiven = Integer . parselnt ("" + buttonObj ectChoicel . getText ()) ; 

The preceding line gets the value on the button using two methods. First, getText 
gets the number as a string and then Integer . parselnt converts it to an integer. 

The value is stored in our answerGiven variable. The following code executes next: 

if (answerGiven==correctAnswer) { //yay it's the right answer 
Toast .makeText (getApplicationContext () , "Well done!", 

Toast. LENGTH_LONG) . show ( ) ; 

}else{//uh oh! 

Toast . makeText (getApplicationContext (), "Sorry that's wrong", 

Toast . LENGTH_LONG) . show ( ) ; 

} " 

The if statement tests to see if the answerGiven variable is the same as 
correctAnswer using the == operator. If so, the makeText method of the Toast 
two variables 

are not the same, the message displayed is a bit more negative one. 




The Toast line of code is possibly the most evil thing we have seen 

knowledge of Java than we have at the moment to understand. All we 
e 

By the end of Chapter 6, OOP - Using Other People's Hard Work, the code 
for Toast will be clear. If you really want an explanation now, you can 
think of it like this: when we made button objects, we got to use all the 
button methods. But with Toast, we used the class directly to access 
its makeText method without creating an object first. We can do this 
process when the class and its methods are designed to allow it. 
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Finally, we break out of the whole switch statement as follows: 

break ; 
ned in 

this chapter, why not test your understanding of everything you've learned so far? 

Self-test questions 

Ql) What does this code do? 

// setContentView (R . layout . activity_main) ; 

Q2) Which of these lines causes an error? 

String a = "Hello" ; 

String b = " Vinton Cerf"; 
int c = 55; 
a = a + b 
c=c+c+10; 
a = a + c ; 
c = c + a ; 

used 

together to build complicated expressions. Expressions, at a glance, can sometimes 

make the code look complicated. However, when looked at closely, they are not as 

ons into smaller 

convoluted 

ou work out: 

what will x be? 

int x = 10; 
int y = 9; 

boolean isTrueOrFalse = false; 

isTrueOrFalse = ( ( (x <=y) | | ( x == 10) ) && ( ( ! isTrueOrFalse) j ! 
(isTrueOrFalse) ) ) ; 
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Summary 

a syntax 

to learning about comments, variables, operators, and decision making. 


learning, and increasing our vocabulary. At this point, the temptation might be to 
hold back until mastery of the current Java syntax has been achieved, but the best 
ave already 
begun to learn. 

In the next chapter, we will finally finish our math game by adding random 
questions of multiple difficulties as well as using more appropriate and random 
wrong answers for the multiple choice buttons. 

To enable us to do this, we will first learn some more Java. 
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code in a 
a. These 

include while loops, do-while loops, and for loops. We will learn about the best 
occasions to use the different types of loops. 

Then we will briefly cover the topic of random numbers. We will also see how the 
Java Random class can be used. This will obviously be of great help in enhancing our 
math game. 

Next, we will look at methods. They allow us to compartmentalize our code into 
ds and 

divide programming tasks to simplify problems, 
d 

nge 

the question after each time we attempt the answer. 

We will also add question difficulty levels and random questions within a range 
appropriate for a given difficulty level. We will show and update our score. The 
score goes up faster depending upon the difficulty level of the question answered 
be beaten 

by the game. Nevertheless, most of us will hopefully get a bit further than what is 
shown in the next screenshot. 
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If the player gets a question wrong, the difficulty goes back to the easiest level and 


2x2 


BBS 

Well done! 

Score: 1 0 Level: 4 

CHH] C5 1 


In this chapter we will: 

• Learn about looping in multiple types of loops 

• Learn how to generate random numbers in Java 

• Learn everything about Java methods, including how to write and call them 

• Significantly enhance our math game 

Looping with loops 

ramming, 

but they are exactly what the name implies. They are a way of performing the 
same part of the code more than once, or looping over the same part of code, but 
potentially for a different outcome each time. 
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er 

number 

of times as specified by the loop code itself. It could also prompt the loop when a 
predetermined situation or condition is met. Or there could be a combination of 
more than one of these ways of prompting the loop to end. Along with if, else, 
and switch, loops are part of the Java control flow statements. 

ol our code, 

and after we have looked at methods, we will use some of them to implement the 
enhancements to our math game. Let's proceed to our first type of loop. 

While loops 

A while loop has the simplest syntax. Recollect the if statements in Chapter 3, 
Speaking Java - Your First Game. We can put virtually any combination of operators 
and variables in the conditional expression of the if statement. If the expression 
evaluated to true, then the code in the body of the if block is executed. Similarly, in 
the while loop, we put an expression that can evaluate to true or false, as shown in 
this code: 

int x = 10; 


while (x > 0 ) { 
x ; 

//x decreases by one each pass through the loop 

} 


What is happening here is that outside the while loop, an integer, x, is declared 
and initialized to 10. Then the while loop begins. Its condition is x > 0 , so it will 
tes to false. 

Hence, the code will execute 10 times. 

On the first pass, x is equal to 1 0 , then 9, then 8, and so on. But once x becomes equal 
to 0 , it is obviously no longer greater than 0. So the program will exit the while loop 
and continue with the first line of code after the loop. 

Just like an if statement, it is possible that the while loop will not execute even once. 
Take a look at this example of a while loop that never executes: 

int x = 10; 


while (x > 10 ) { 

//more code here. 

//but it will never run unless x is greater than 10. 

} 
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n or the 

amount of code that can be written in the loop body: 

int playerLives = 3; 

int alienShips = 10; 

while (playerLives >0 && alienShips >0) { 

//Entire game code here. 

//. ■ • 

//. ■ • 

//etc. 

} 

//continue here when either playerLives or alienShips = 0 

The preceding while loop would continue to execute until either playerLives or 
alienShips becomes equal to or less than zero. As soon as one of these conditions 
occurs, the expression evaluates to false and the program continues to execute from 
the first line of code after the while loop. 

It is worth noting that once the body of the loop has been entered, it will always 
complete, even if the expression evaluates to false somewhere in between, as the 
s: 


int x = 1 ; 

while (x > 0 ) { 

X - - ; 

//x is now 0 so the condition is false 
//But this line still runs 
//and this one 
/ /and me ! 


} 

The preceding loop body will execute exactly once. We can also set a while loop that 
will run forever (which is unsurprisingly called an infinite loop), like this: 

int x = 0 ; 
while (true) { 

x++; //I am going to get mighty big! 

} 
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Breaking out of a loop 

We might use an infinite loop like the loop in the preceding example so that we can 
g the break 

ing code: 

int x = 0 ; 
while (true) { 

x++ ; //I am going to get mighty big! 
break; //No you're not haha. 

//code doesn't reach here 

} 

n making 

tools like if, else, and switch within our while loops and the rest of the loops we 
will look at in a minute: 

int x = 0 ; 

int tooBig = 10; 

while (true) { 

x++ ; //I am going to get mighty big! 
if (x == tooBig) { 
break; 

} / /No you ' re not haha . 

//code reaches here only until x = 10 

} 


ility 

of while loops, but at some point, we want to get back to doing some real 
programming. So here is one last concept, combined with while loops. 

The continue keyword 

The continue keyword acts in a way similar to break-up to a point. The continue 
keyword will break out of the loop body but will also check the condition expression 
afterwards, so the loop could run again. The following example will show the use 
of continue: 

int x = 0 ; 

int tooBig = 10; 

int tooBigToPrint = 5; 

while (true) { 
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x++; //I am going to get mighty big! 
if (x == tooBig) { 
break ; 

} //No your not haha . 

//code reaches here only until x = 10 

if (x >= tooBigToPrint) { 

//No more printing but keep looping 
continue ; 

} 

//code reaches here only until x = 5 
//Print out x 


Do-while loops 

A do-while loop is very much the same as a while loop with the exception that it 
evaluates its expression after the body. This means that a do-while loop will always 
execute at least once, as demonstrated in the following code: 

int x= 0 ; 
do{ 
x++ ; 

}while (x < 10) ; 

//x now = 10 



The break and continue keywords can also be used 
in do-while loops. 


] 


For loops 

A for loop has a slightly more complicated syntax than a while and do-while loop 
as it take three parts to initialize. Take a look at the following for loop first. Then we 
will break it apart: 

for(int i = 0; i < 10; i++) { 

//Something that needs to happen 10 times goes here 

} 
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The apparently obscure form of the for loop is clearer when put like this: 

for (declaration and initialization; condition; change after each pass 
through loop) 

To clarify further, we have the following in a for loop: 

• Declaration and initialization: We create a new int variable, i, and initialize 
it to 0. 

• Condition: Just like the other loops, this refers to the condition that must be 
evaluated to true for the loop to continue. 

• Change after each pass through loop: In the preceding example, i++ means 
that 1 is added to i on each pass. We could also use i - - to reduce/ decrement 
i on each pass, which is shown in the following code: 

for(int i = 10; i > 0; i — ) { 

/ /countdown 


//blast off i = 0 



Note that break and continue can also be used in for loops. 


The for and the 

control variable on itself. We will be using a for loop to enhance our math game 
right after we take a look at random numbers and methods. 


Random numbers in Java 


Before we dive into methods, we will first take a look at how we can create random 
numbers because this is how we will generate our random questions. 

All the hard work is done for us by the Random class. First we need to create an object 
of the Random type: 

Random randlnt = new Random ( ) ; 

Then we use our new object's nextlnt method to generate a random number within 
a certain range: 

int ourRandomNumber = randlnt . nextlnt (10); 
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The range for the number that we enter starts from zero. So the preceding line of 
number 

between 1 and 10, we just do this: 

ourRandomNumber++ ; 



going on in objects like Random. In Chapter 6, OOP - Using Other 
People's Hard Work, we will be ripping open the black boxes and even 
making our own. We will be able to write our own classes and our 
own methods within those classes. 


Methods 

So what exactly are Java methods? A method is a collection of variables, expressions, 
and control flow statements. We have already been using lots of methods; we just 
haven't looked inside any yet. 

Learning about Java methods will be the last topic for this chapter before we get 
practical and use what we have learned to enhance our math game. 

The structure of a method 

The first part of a method that we write is called the signature. Here is a made-up 
example of a signature: 

public boolean shootLazers ( int number, string type) 

Add an opening and closing pair of curly braces with some code that the method 
performs, and we have a complete method, or a definition. Here is a made-up but 
syntactically correct method: 

private void setCoordinates ( int x, int y) { 

//code to set coordinates goes here 

} 


//I like it here 

setCoordinates (4 , 6 ); //now I am going off to setCoordinates method 
//Phew, I'm back again - code continues here 
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At the point where we call setcoordinates, our program's execution would branch 
es its end or 

is told to return. Then the code would continue running from the first line after the 
method call. 

method 

return to the code that called it: 

int addAToB(int a, int b) { 
int answer = a + b; 
return answer; 

} 

The call to use the preceding method could look like this: 
int myAnswer = addAToB ( 2 , 4 ) ; 

Clearly, we don't need to write methods to add two int variables together, but the 
First, we 

pass the values 2 and 4. In the signature of the method, the value, 2 , is assigned to 
int a and the value, 4, is assigned to int b. 

Within the method body, the a and b variables are added and used to initialize a new 
variable, which is the int answer. The return answer line does just that. It returns 
the value stored in answer to the calling code, causing myAnswer to be initialized 
with the value of 6. 

es a little. 

The reason for this is that the Java method signature is quite flexible, allowing us to 
build exactly the methods we require. 

Exactly how the method signature defines how the method must be called and how 
a method must return a value, if it must, deserves further discussion. Let's give each 
part of that signature a name so that we can break it into chunks and learn about the 
parts separately. 

Here is a method signature with its parts labeled and ready for 
jki discussion. You can also take a look at the following table to further 
( ) identify which part of the signature is which. This will make the rest 

\3 of our discussion on methods straightforward. 

Modifier | return type | name of the method (parameters) 
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identify the 

part of the signature under discussion: 


Part of signature 

Examples 

Modifier 

public, private, and so on 

Return type 

int, boolean, float, and so on, or any Java type, expression, or 
object 

Name of the method 

shootLazers, setCoordinates, addAToB, and so on 

Parameters 

(int number, string type), (int x, int y), (int a, int b), 
and so on 


Modifier 

In our previous examples, we only used a modifier twice, partly because the method 
doesn't have to use the modifier. The modifier is a way of specifying which code can 
use your method. Some of the types of modifiers are public and private. Actually, 
regular variables can have modifiers too, such as these: 

//Most code can see me 
public int a; 

//Code in other classes can't see me 
private string secret = "Shhh, I am private"; 

Modifiers (for methods and variables) are an essential Java topic but they are best 
ound a few 

times so far — objects and classes. 

As previously promised, these mysterious objects will be revealed in 
Chapter 6, OOP - Using Other People's Hard Work. However, as we can 
see from our example methods and from the fact that all the examples 
we have written so far work just fine, modifiers are not necessary to 
facilitate our learning so far. 

Return type 

Next up is the return type. Like a modifier, a return type is also optional, although 
seen that our 
they have 



int addAToB(int a, int b) { 
int answer = a + b; 
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return answer; 

} 

In this code, the return type in the signature is highlighted. So the return type is 
int. The addAToB method sends back (returns) to the code that called it a value that 
will fit in an int variable. 

The return type can be any Java type we have seen so far. The method, however, 
use the 

void keyword as the return type. When the void keyword is used, the method 
ror. It can, 

however, use the return keyword without a value. Here are some combinations of 
return type and uses of the return keyword that are valid: 

void doSomething ( ) { 

/ / our code 

//I'm done going back to calling code here 
//no return is necessary 

} 


Another combination of return and void is as follows: 

void doSomethingElse ( ) { 

/ / our code 


//I can do this as long as I don't try and add a value 
return; 


The following code is yet another combination of return and void: 

void doYetAnotherThing ( ) { 

//some code 
if (someCondition) { 

//if someCondition is true returning to calling code 

/ /before the end of the method body 

return; 

} 

//More code that might or might not get executed 
return; 

//As I'm at the bottom of the method body 
//and the return type is void, I'm 
//really not necessary but I suppose I make it 
//clear that the method is over. 
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} 

String j oinTogether (String firstName, String lastName) { 
return firstName + lastName; 

} 


We can call each of the preceding methods one by one, like this: 

//OK time to call some methods 
doSomething ( ) ; 
doSomethingElse ( ) ; 
doYetAnotherThing ( ) ; 

String fullName = joinTogether ( " Jef f ","Minter") 

//fullName now = Jeff Minter 
//continue with code from here 

The preceding code would execute all the code statements in each 
method one by one. If the method signature had parameters, the 
code that calls the method would look slightly different. 



Name of a method 

is a 
other 

convention is of the first letter of the first word in the name being lower case, and the 
first letter of each of the subsequent words being uppercase. This is called camel case 
because the shape the name can form has a hump in it: 

XGHHY7 8 8 02c ( ) { 

//code here 

} 


ook at a much 

clearer example that uses the conventions: 


doSomeVerySpecif icTask ( ) { 
//code here 

} 


getMySpaceShipHealth ( ) { 
//code here 

} 


startNewGame ( ) { 
//code here 

} 
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These are much clearer method names. 

Now let's take a look at parameters. 

Parameters 

e need 

to share some data values from the calling code with the method? Parameters 
e with 

parameters when looking at return types. We will look at the same example but a 
little more closely: 

int addAToB(int a, int b) { 
int answer = a + b; 
return answer; 

} 

The parameters in this code are highlighted. Notice that in the first line of the 
method body, we use a + b as if they are already declared and initialized. Well, 
declaration, 

and the code that calls the method initializes them: 

int returnedAnswer = adcLAToB ( 10 , 5 ) ; 


int in our 

s. We can 

mix and match types as well. We can also use as many parameters as necessary to 
solve our problem. An example of mixed Java types might help: 

void addToAddressBook (char f irstlnitial , String lastName, String city, 
int age) { 

//all the parameters are now living breathing, 

//declared and initialized variables 


//code to add details to address book goes here 

} 

It's now time to get serious about our body. 

Getting things done in the method body 

s: 


//code here 

//some code 
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e have 
ck, all of the 
method. 

For example, we wrote code in the onCreate and onClick methods. 

ething in 
the body. 

Using methods 

We don't 

new blank project for each of the next two explorations into methods. 

We also don't need to spend time making a UI. We will use the Android console to 
view the results and discuss the implications of our examples of methods. As we are 
we will 
device. 



have not covered that in this book. If you want to find out more about 
using your actual device for debugging, take a look at the article at 
http : / / developer . android . com/ tools/device . html. 


As usual, you can open the already typed code files in the usual way. The next two 
n the 

Chapter4 folder and the AWorkingMethod and ExploringMethodOverloading 
subfolders. 


The following is a quick reminder on how to create a 
new blank project. 

1. Close any currently open projects by navigating to File | Close Project. 

2. Click on New Project.... 

3. The Create New Project configuration window will appear. Fill in the 
Application name field and Company Domain with packtpub . com, 
or you could use your own company website's name here instead. 
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4. Now click on the Next button. On the next screen, ensure that the Phone 
and tablet checkbox has a tick in it. Now we have to choose the earliest 

he 
port, 
he fewer 
to 

select API 8: Android 2.2 (Froyo). Go ahead and do that now as shown in the 
next screenshot. 

5. Click on Next. Now select Blank Activity and click on Next again. 

6. On the next screen, simply change Activity Name to MainActivity and click 

on Finish. 

7. As we did in Chapter 2, Getting Started with Android, to keep our code clear and 
simple, you can delete the two unneeded methods (onCreateOptionsMenu 
and onOptionsItemSelected) and their associated ©override and @import 
statements, but this is not necessary for the example to work. 

For a detailed explanation and images of creating a new project, see Chapter 2, Getting 
Started with Android. 

A working method 

First, let's make ourselves a simple working method, complete with return types and 
a fully functioning body. 

This method will take three numbers as parameters and return a true or false value 
randomly 

generated within the method or not: 

1. Create a new blank project called A Working Method. 

2. In this method, we will use the Random class we saw earlier and its randlnt 
method as a part of the demonstration. Copy the code for this method 
after the closing bracket of onCreate but before the closing bracket of 
MainActivity. When you are prompted to import any classes, simply click 
on OK: 

boolean guessANumber ( int tryl, int try2, int try3){ 

//all the Log.i lines print to the Android console 
Log . i (" info" , "Hi there, I am in the method body"); 

/ /prove our parameters have arrived in the method 


/ /By printing 

them in 

the 

console 

Log . i i 

! " info" , 

"tryl = 

" + 

tryl) ; 

Log . i i 

! " info" , 

"try2 = 

" + 

try 2 ) ; 

Log . i i 

( " info" , 

"try3 = 

" + 

try 3 ) ; 
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3. Now we declare a Boolean variable called found and initialize it to false. 
We will change found to true if and when we guess the random number 
correctly. Next, we declare our random number and print some useful 
values to the console: 

//we use the found variable to store our true or false 
//setting it to false to begin with 
boolean found = false; 

//Create an object of the Random class so we can use it 
Random randlnt = new Random ( ) ; 

//Generate a random number between 0 and 5 
int randNum = randlnt . nextlnt ( 6 ) ; 

//show our random number in the console 

Log . i (" info" , "Our random number = " + randNum); 

4. The last portion of code in our method tests to see whether there is a 
match for any of our passed-in parameters, prints some output, and then 
returns true or false using the found variable to the calling code in the 
onCreate method: 

//Check if any of our guesses are the same as randNum 
if (tryl == randNum | | try2 == randNum | | try3 == 
randNum) { 
found = true; 

Log . i (" info" , "aha!"); 

} else { 

Log. i ( "info" , "hmmm"); 

} 

return found; 

} 

5. Now write this code just before the closing bracket of the onCreate method 
to call the code and print some values to the Android console: 

//all the Log.i lines print to the Android console 
Log . i ( " inf o" , "I am in the onCreate method"); 

//Call guessANumber with three values 
//and if true is returned output - Found it! 
if (guessANumber ( 1,2,3 )) { 

Log . i ( " inf o" , "Found It!"); 

}else{//guessANumber returned false -didn't find it 
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Log.i ("info", "Can't find it"); 

} 


//continuing with the rest of the program now 
Log . i ( " inf o" , "Back in onCreate") ; 

6. Launch an emulator. 

7. Run the app on the emulator. 

8. All our console messages have a tag called info. The console window will 
already have appeared underneath the editor window. We can filter its 
contents to only show our messages by typing info in the search box, as 
shown in the following screenshot: 


.og level: 

Verbose 

info 

app: com.packtpub.aworkingmethod.appjj 



I/info 
I/info 
1/ info 
1/ info 
I/info 
I/info 
1/ info 
1/ info 
I/info 


I am in the onCreate method 

Hi there, I am in the method body 

tryl = 1 

try2 = 2 

try3 = 3 

Our random number = 0 
hmmm 

Can't find it 
Back in onCreate 


3 

♦ 

* 

i? 

© 

Cm 


In the preceding screenshot, you can see the search filter and the console output. We 
will now run through the code and explain the output. 

date, time, and 
ealing 

with a random number, so your output may vary: 

info: I am in the onCreate method 
info: Hi there, I am in the method body- 
info: tryl = 1 
info:try2 = 2 
info:try3 = 3 

info: Our random number = 0 
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info : hmmm 
info:Can't find it 
info: Back in onCreate 

Here is what is happening. In step 2, we started writing our first method. We called 
it guessANumber. It has three int parameters and will return a Boolean. Remember 
that these three int parameters become fully initialized variables. First of all, 
passed 

in as parameters as well as a message confirming that the code in our method is 
currently being executed: 

boolean guessANumber ( int tryl, int try2 , int try3){ 

//all the Log.i lines print to the Android console 
Log . i ( " inf o" , "Hi there, I am in the method body"); 

//prove our parameters have arrived in the method 
//By printing them in the console 
Log . i ( " inf o" , "tryl = " + tryl); 

Log . i ( " inf o" , "try2 = " + try2); 

Log . i ( " inf o" , "try3 = " + try3); 

In step 3, we added more code to our method. We declared and initialized a Boolean 
variable called found, which we will use to return a value to the calling code and let 
me as the 
random number: 

//we use the found variable to store our true or false 
//setting it to false to begin with 
boolean found = false; 

s we did 

earlier in the chapter. We also used Log to output the random number so that we 
can examine what went on: 

//Create an object of the Random class so we can use it 
Random randlnt = new Random ( ) ; 

//Generate a random number between 0 and 5 
int randNum = randlnt . nextlnt ( 6 ) ; 

//show our random number in the console 

Log . i ( " inf o" , "Our random number = " + randNum); 

In step 4, we used an if statement with the logical OR operator to detect whether 
ted, 

as shown in the following code: 

//Check if any of our guesses are the same as randNum 
if (tryl == randNum | | try2 == randNum | | try3 == randNum) { 


[ 122 ] 



Chapter 4 


If the condition is true, that is, if any of tryl, try2, or try3 equals randNum, then 
the following code is run. Our found Boolean value is set to true and a message 
is printed: 

found = true; 

Log . i (" info" , "aha!"); 

If the condition is not true, the else statement is executed, a different message is 
printed, and the found variable is left the same as it was — false: 

}else{ 

Log . i ( " inf o" , "hmmm"); 

} 

Finally, in our method, we return the found variable, which will be either true or 
false, to the calling code: 

return found; 

} 

Now we look at step 5, which is the code in the onCreate method, which calls our 
guessANumber method in the first place. We start by simply printing a message 
saying that we are in onCreate at the moment: 

//all the Log.i lines print to the Android console 
Log . i ( " inf o" , "I am in the onCreate method"); 

Then we make the call to guessANumber with the three parameters. In this case, we 
use 1, 2, and 3, but any int values would have worked. However, we wrap the call 
in an if statement. This means that the return value from the method will be used 
to evaluate the if statement. Simply put, if true is returned, the if statement will be 
executed and "Found It!" will be printed: 

//Call guessANumber with three values 
//and if true is returned output - Found it! 
if (guessANumber (1,2,3) ) { 

Log . i (" info" , "Found It!"); 

} " 

On the contrary, if false is returned, the else statement gets executed and "Can't 
find it" is printed: 

else { //guessANumber returned false -didn't find it 
Log.i ("info", "Can't find it"); 

} 


//continuing with the rest of the program now 
Log . i ( " inf o" , "Back in onCreate") ; 
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un it a 

few times before you see this output: 


I am in the onCreate method 

Hi there, I am in the method body 

tryl = 1 

try2 = 2 

try 3 = 3 

Our random number = 3 
aha ! 

Found It! 

Back in onCreate 


meters are 
plicated, 

they will together have a 50 percent chance of finding the random number. 

should be 
this one. 

Printing variable values to the console is a great way to 
examine what is going on inside your game and to find bugs. 

Let's look at another example of methods. 

Exploring method overloading 

hopefully, 

taking a step at a time, we will see they are not daunting in any way. We will be 
We 

will be exploring methods even more deeply in Chapter 6, OOP - Using Other People's 
Hard Work. For now, however, it will serve us well to look at one more topic on 
methods. Let's create a new project to explore method overloading. 

As we will now see, we can create more than one method with the same name, 
provided the parameters are different. The code in this project is vastly simpler 
than that of the last project. It is how this code works that might appear slightly 
curious until we analyze it later: 

1. Create a new blank project called Exploring Method Overloading. 
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2. In the first method, we will simply call it printstuf f and pass an int variable 
via a parameter to be printed. Copy the code for this method after the closing 
bracket of onCreate but before the closing bracket of MainActivity. When 
you are prompted to import any classes, simply click on OK: 

void printstuf f (int mylnt) { 

Log . i ( " inf o" , "This is the int only version"); 

Log . i ( " inf o" , "mylnt = "+ mylnt); 

} 

3. We will also call the second method printstuf f but pass a string variable 
f 

onCreate but before the closing bracket of MainActivity. Again, when you 
are prompted to import any classes, simply click on OK: 
void printStuff (String myString) { 

Log . i ( " inf o" , "This is the String only version"); 

Log . i ( " inf o" , "myString = "+ myString); 

} 

4. Yet again, we will call this third method printStuff but pass a string 
variable and an int variable to be printed. As before, copy the code for this 
method after the closing bracket of onCreate but before the closing bracket 
of MainActivity: 

void printStuff (int mylnt, String myString) { 

Log . i ( " inf o" , "This is the combined int and String 
version" ) ; 

Log . i ( " inf o" , "mylnt = "+ mylnt); 

Log . i ( " inf o" , "myString = "+ myString); 

} 

5. Now write this code just before the closing bracket of the onCreate method 
to call the methods and print some values to the Android console: 

//declare and initialize a String and an int 

int anlnt = 10; 

String aString = "I am a string"; 

//Now call the different versions of printStuff 
//The name stays the same, only the parameters vary 
printStuff (anlnt) ; 
printStuff (aString) ; 
printstuf f (anlnt , aString); 

6. Launch an emulator. 

7. Run the app on the emulator. 
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Here is the console output: 

info: This is the int only version 
info: mylnt = 10 

info: This is the String only version 
info: myString = I am a string 

info: This is the combined int and String version 

info: mylnt = 10 

info: myString = I am a string 

ally 

different methods. This, as we have just demonstrated, can be really useful. 
It is called method overloading. 



Method overloading and overriding confusion 

Overloading and overriding are defined as follows: 

• Overloading occurs when we have more than one method with 
the same name but different parameters 

• Overriding occurs when we essentially replace a method with 
the same name and the same parameter list 

We know enough about overloading and overriding to complete this 


an overloaded method. However, that is something for another time. 


and 4), we 

create a method called printstuf f, but each printstuf f method has different 

r- 

void printstuf f (int mylnt) { 


void printStuff (String myString) { 

} 

void printStuff (int mylnt, String myString) { 


The body of each of the methods is simple. It just prints the passed-in parameters 
and confirms which version of the method is being called currently. 
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d we 

want to call, using the appropriate parameters. In step 5, we call each of them in turn, 
uired: 


printStuff (anlnt) ; 
printStuff (aString) ; 
printStuff (anlnt , aString); 


make some improvements to our math game. 

Enhancing our math game 

St 

learned about methods and loops. 

As usual, the code is available for copying in the Chapter4 folder of the code 
download. The project is in the MathGameChapter4 subfolder and encompasses all 
nhancing 

the UI, amending our game activity, setQuestion, updateScoreAndLevel, 
isCorrect, and calling our new methods. 

We will make the game change the question after each time we attempt the answer. 

We will also add difficulty levels to questions and random questions but within a 
range appropriate for that difficulty level. 

We will show and update our score. The score goes up faster depending on the 
difficulty level of the question answered correctly. 

If the player gets a question wrong, the difficulty goes back to the easiest level and 
the score to zero. 

Enhancing the UI 

Let's get on with modifying our math game UI to incorporate our new game features. 
We will be adding a TextView to display the score and another TextView to display 
the level. 

1. Open the activity_game . xml file in the editor window. We will add a new 
TextView to the very bottom of our UI for our score. 

2. Drag a Large Text element from Palette and place it to the left, below our 
three answer buttons. 
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3. Now we need to change the id property so that we can access our new 
TextView from our Java code. Ensure that the new TextView is selected 
by clicking on it. Now, in the Properties window, change the id property 
to textScore. 

4. For the sake of clarity (although this step serves no use in programming), 
change the text property to Score : 999. 

5. Now put another Large Text element to the right of the one we just configured 
and change the id property to textLevel. The lower part of our UI should 
now look like this: 


0 0 

Score: 999 

Level: 4 

<-=> C23 

cfzi 1 


6. Once again, for the sake of clarity (although this step serves no use in 
programming), change the text property to Level : 4. 

7. Save the project. 

D that 

we can refer to in our Java code. 



You have probably realized by now that the precise layout and size of 
our UI elements are unimportant as far as getting the game to work 
is concerned. This gives us a lot of flexibility in designing layouts 
for different screen sizes. As long as each layout for each screen size 
contains the same element types with the same IDs, the same Java 
code will work for different layouts. If you want to know more about 
designing for multiple screen sizes, take a look at http : / /developer . 
android . com/ training/multiscreen/ screensizes . html. 


Now that we have our enhanced UI and an understanding of how the Java Random 
class works, we can add the Java code to implement our new features. 
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The new Java code 

As previously explained, the project code is available in the chapter4 folder of the 
downloadable code. The project is called MathGameChapter4 and encompasses all 
the improvements covered in this chapter. 

In this phase, we will be adding lots of new code, moving some existing code, and 
modifying some existing code too. As so much is changing, we are going to approach 
ely, the 
has stayed 

the same and in the same place will have the least explanation. 

We will first make some modifications and deletions to our existing code. We will 
ve our 

code and add our new features. 

Amending GameActivity 

First, let's perform the necessary amendments and deletions to our current code: 

1. Open the GameActivity . j ava file in the editor window. 

2. We now need to consider the scope of the objects that represent our UI 
elements. Both textObjectPartA and textObj ectPartB need to be 
accessible from the methods we will be creating soon. So let's move their 
apter, 

out of the onCreate method so that they are accessible everywhere in our 
GameActivity class. The following code shows all our declarations so far. 
They are present immediately after the start of the GameActivity class. 

The recently added (or moved) declarations are highlighted. Notice that 
we have also added declarations for our two new TextViews and for the 
score and level displays. In addition, there are two new int variables that 

currentScore and currentLevel: 

public class GameActivity extends Activity implements View. 

OnCl ickLi stener { 


int correctAnswer ; 

Button buttonObj ectChoicel ; 
Button buttonObj ectChoice2 ; 
Button buttonObj ectChoice3 ; 

TextView textObjectPartA; 
TextView textObj ectPartB; 
TextView textOb j ectScore; 
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TextView textOb j ectLevel ; 

int currentScore = 0 ; 
int currentLevel = 1; 

3. All of the code that assigns text to our Buttons or TextViews objects, and the 
or our 

all. Everything shown in the following code is to be deleted: 

//Here we initialize all our variables 
int partA = 9 ; 
int partB = 9 ; 

correctAnswer = partA * partB; 

int wrongAnswerl = correctAnswer - 1; 

int wrongAnswer2 = correctAnswer + 1 ; 

4. The following code snippet needs to be deleted too: 

//Now we use the setText method of the class on our objects 
//to show our variable values on the UI elements. 
textOb j ectPartA . setText (" " + partA); 
textOb j ectPartB . setText (" " + partA); 

//which button receives which answer, at this stage is arbitrary. 
buttonObj ectChoicel . setText (" " + correctAnswer); 
buttonObj ectChoice2 . setText (" " + wrongAnswerl); 
buttonObj ectChoice3 . setText ( " " + wrongAnswer2 ) ; 

5. For clarity and context, here is the entire onCreate method as it currently 
s 

code 

includes our two new TextViews, which are highlighted, but everything else, 
which is described in steps 3 and 4, is deleted. As before, there is a piece of 
code that makes our game listen to button clicks: 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate ( savedlnstanceState) ; 

//The next line loads our UI design to the screen 
setContentView (R. layout . activity_game) ; 


/*Here we get a working object based on either the button 
or TextView class and base as well as link our new 
obj ects 
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directly to the appropriate UI elements that we created 
previously*/ 

textOb j ectPartA = (TextView) findViewByld (R. id. textPartA) ; 
textOb j ectPartB = (TextView) findViewByld (R. id. textPartB) ; 

textOb j ectScore = (TextView) findViewByld (R. id. textScore) ; 

textOb j ectLevel = (TextView) findViewByld (R . id. textLevel) ; 

buttonOb j ectChoicel = (Button) findViewByld (R. 
id . buttonChoicel ) ; 

buttonOb j ectChoice2 = (Button) findViewByld (R . 
id . buttonChoice2 ) ; 

buttonOb j ectChoice3 = (Button) findViewByld (R. 
id . buttonChoice3 ) ; 

buttonOb j ectChoicel . setOnClickListener ( this ) ; 
buttonOb j ectChoice2 . setOnClickListener (this) ; 
buttonOb j ectChoice3 . setOnClickListener (this) ; 

}//onCreate ends here 

6. Now we will delete some more code that we don't need because we are going 
to make it more efficient by compartmentalizing it into our new methods 
and adding our new features at the same time. So in our onClick method, 
in each case of our switch statement, we want to delete the if and the else 
statements. We will be completely rewriting these, but we will leave in place 
the code that initializes our answerGiven variable. Our onClick method will 
now look like this: 

©Override 

public void onClick (View view) { 

//declare a new int to be used in all the cases 
int answerGiven=0 ; 
switch (view.getld ( ) ) { 

case R . id . buttonChoicel : 

//initialize a new int with the value contained in 
buttonOb j ectChoicel 

//Remember we put it there ourselves previously 
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answerGiven = Integer . parselnt (" " + 
buttonObjectChoicel . getText ( ) ) ; 

break ; 

case R . id . buttonChoice2 : 

//same as previous case but using the next button 
answerGiven = Integer . parselnt (" " + 
buttonOb j ectChoice2 . getText ( ) ) ; 

break ; 

case R . id . buttonChoice3 : 

//same as previous case but using the next button 
answerGiven = Integer . parselnt (" " + 
buttonOb j ectChoice3 . getText ( ) ) ; 

break ; 


7. Save your project, 
new 

d TextView 
ur class. 

r be making the 

question or populating the multi-choice buttons in onCreate, as this is not flexible 
enough. We will soon see how we improve on this. 

t or 

incorrect. However, as we saw, we still initialized the answerGiven variable in the 
same way — in the appropriate case of our switch statement in the onClick method. 

Great! Now we are ready to consider and design some new methods to 
atures. 

Consider the following methods that we will soon implement. 
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The methods 

ds will 
ures 

from causing the code to become too long and sprawling: 

• We will write a setQuestion method to prepare a question of appropriate 
difficulty. 

• We will write an updateScoreAndLevel method that will do just that. We 
will also write an isCorrect method that one of our other methods will use 
to evaluate the correctness of the answer. 

• Then we will strategically place the code that calls our new methods. 

We will do each of these tasks one at a time and explain the code along the way, as 
leaving the explanation to the end will make referring to individual steps cumbersome. 

and the 

previous chapter. These include the following: 

• Methods 

• A for loop 

• The switch control structure 

So let's get started with our first method. 


The setQuestion method 

We determined that we needed a method to prepare a question for us; setQuestion 
seems like a decent name for such a method. Every time our player gives an answer by 
tapping one of the three multi-choice buttons, a new question will need to be prepared. 

This method will need to generate values for our partA and partB variables as 
well as show them in our TextViews referenced by the textObj ectPartA and 
textobj ectPartB objects. In addition, the method will need to assign the new 
correct answer to our correctAnswer variable, which will then be used to calculate 
correct and 

incorrect answers on our multi-choice buttons. 
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Furthermore, our setQuestion method will need to take into account the level held 
in currentLevel to determine the range or difficulty of the question it will ask. Let's 
go through the code. If you want to type this code as we go, then just make sure you 
place it after the closing bracket of ondick but before the closing bracket of our 
GameActivity class: 

1. First of all, we have the method signature and the opening curly brace before 
the body of our method: 

void setQuestion () { 

2. This tells us that the return type is void, so setQuestion will not return a 
it does 

enter the code to generate the two parts of the question: 

//generate the parts of the question 
int numberRange = currentLevel * 3 ; 

Random randlnt = new Random ( ) ; 

int partA = randlnt . next Int (numberRange) ; 
partA++ ; //don 1 1 want a zero value 

int partB = randlnt . nextlnt (numberRange) ; 
partB + + ; //don 1 1 want a zero value 

3. In the previous step, we declared a new int variable, numberRange, and 
initialized it by multiplying the player's currentLevel value by 3. Then we 
got a new Random object called randlnt and used it to generate new values 
based on numberRange. We did this to the partA and partB variables. As 
the value of currentLevel increases, so potentially does the difficulty of the 
question. Now, just as we have written in the past, we write this: 
correctAnswer = partA * partB; 

int wrongAnswerl = correctAnswer-2 ; 
int wrongAnswer2 = correctAnswer+2 ; 

textOb j ect PartA. setText ( " " +partA) ; 
textOb j ect PartB . setText ( " " +partB) ; 

4. We assigned the answer of our new multiplication question to 
correctAnswer. Then we declared and assigned two incorrect answers to 
the new int variables, wrongAnswerl and wrongAnswer2. We also used 
the setText method of our TextView objects to display the question to 
ect 

answers. Here it is. Try to work out what is happening here: 

//set the multi choice buttons 
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//A number between 0 and 2 

int buttonLayout = randlnt . nextlnt (3 ) ; 

switch (buttonLayout) { 

case 0 : 

buttonOb j ectChoicel . setText ( " " +correctAnswer ) ; 
buttonOb j ectChoice2 . setText ( " " +wrongAnswerl ) ; 
buttonOb j ectChoice3 . setText ( " " +wrongAnswer2 ) ; 
break; 


case 1 : 

buttonOb j ectChoice2 . setText ( " " +correctAnswer ) ; 
buttonOb j ectChoice3 . setText ( " " +wrongAnswerl ) ; 
buttonOb j ectChoicel . setText ( " " +wrongAnswer2 ) ; 
break; 


case 2 : 

buttonOb j ectChoice3 . setText ( " " +correctAnswer ) ; 
buttonOb j ectChoicel . setText ( " " +wrongAnswerl ) ; 
buttonOb j ectChoice2 . setText ( " " +wrongAnswer2 ) ; 
break; 

} 


5. In the preceding code, we used our Random object, randlnt, to generate a 
number between 0 and 2, and assigned the value to a new int variable called 
buttonLayout. We then used buttonLayout to switch between all its possible 
values: 0, 1, or 2. Each case statement sets the correct and incorrect answers 
can't 

just keep tapping the same button over and over to achieve a massive score. 
Notice the extra closing bracket after the closing bracket of the switch. This is 
the end of our setQuestion method. 

We explained the code fairly thoroughly as we went through it but it might be 
worthwhile to just take a closer look at some parts again. 
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In step 1, we saw our method signature with a void return type and no parameters, 
n range. 

This range isn't as obvious as it might seem at first. First, we assigned, declared, 
and initialized numberRange like this: 

int numberRange = currentLevel * 3 ; 

So if the player is at the first question, then currentLevel will hold the value l 
and numberRange will be initialized as 3. Then we made a new Random object as 
previously discussed and entered this line of code: 

int partA = randlnt . nextlnt (numberRange) ; 

What occurs here is that the nextlnt method of the Random object, randlnt, will 
return a value of either 0, 1, or 2 because we have given it a seed of 3. We don't want 
any zeros in our game because they result in very easy multiplication, so we enter this: 

partA++ ; //don 1 1 want a zero value 

This operator, which you probably remember from Chapter 3, Speaking Java - Your 
First Game, when we discussed operators, adds 1 to partA. We then do exactly the 
same to our partB variable, which means that assuming that the player is still on 
level 1, they will have a question that will be one of the following: 

1 x 1, 1 x 2, 1 x 3, 2 x 1, 2 x 2, 2 x 3, 3 x 1, 3 x 2, or 3 x 3 

gnificantly. So 

at level 2, the options are that either part of the question could be from 1 to 6; for 
level 3, from 1 to 9; and so on. It is still possible to get an easy question on a higher 
step, we display 

the question to the player using the setText method, 
alculate and 

assign a value for correctAnswer, and declare and assign values to wrongAnswerl 
and wrongAnswer2, which will hold the wrong answer choices for our buttons. 

Part 3 varies very slightly from what we did in onCreate in the previous chapter 
because we subtract and add 2 to wrongAnswerl and wrongAnswer2, respectively, 
er because 

you can't eliminate answers based on whether they are odd or even, 
will 

comes to 
simply use 

our Java code to discover it as we did in Chapter 3, Speaking Java - Your First Game. 
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The updateScoreAndLevel method 

The name of this method speaks for itself. Because the keeping of the score is 

will 

to 

make modifications to the scoring system, they can all take place in there. 

Let's write the code. 

1. This code can go anywhere within the opening and closing braces of 
GameActivity { }, but it is good practice to place them in the approximate 
order they will be used. So why not start adding your code after the 
closing brace of setQuestion but obviously before the closing brace of 
GameActivity? Here is the method signature with the opening brace: 
void updateScoreAndLevel ( int answerGiven) { 

2. This tells us that our method does not return a value but that it does receive 
an int 

big clue to what we will be passing. We will see that in action in the body 
f the 

isCorrect method is a bit confusing, we will see things become clearer in 
the next chunk of code. Here is the next part of the code to add: 

if (isCorrect (answerGiven) ) { 

for (int i = 1; i <= currentLevel ; i++) { 
currentScore = currentScore + i; 

} 

currentLevel++ ; 

} 

3. There is a lot happening here, so we will dissect it more once we have the 
method completed. Basically, it calls the isCorrect method (which we will 
write soon) and if the response is true, adds to the player's score in a for 
loop. After that, the method adds 1 to currentLevel. Here comes the 
else part of the code in case the response from isCorrect is false: 
else{ 

currentScore = 0; 
currentLevel = 1; 

} 
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4. If the response is false, that is, if the player got the answer wrong, the 
currentscore variable is set to o and the level back to l. Finally for this 
method, we type the following: 

/ /Actually update the two TextViews 

textObj ectScore . setText (" Score : " + currentscore); 

textObj ectLevel . setText ( "Level : " + currentLevel); 

} 

5. In the previous step, we updated the actual TextViews that the player 
sees with the newly determined score and level. The method then 
ended and the control of the program returned to the code that called 
updateScoreAndLevel to begin with. Save your project. 

review 

it and dig a bit deeper into certain parts, especially the call to isCorrect in that 
odd-looking if statement. 

In step 1, we began with the method signature. Then in step 2, we began with the 
aforementioned curious if: 

if (isCorrect (answerGiven) ) { 

We have seen this type of statement before in the A working method example in the 
Methods section of this chapter. What is happening here is that the call to isCorrect 
is replacing the statement to be evaluated, or rather it is the statement to be 
evaluated. So isCorrect is called with the answerGiven variable. The answerGiven 
variable, as you might remember, was passed to updateScoreAndLevel. This time, 
it is passed to the isCorrect method, which will do some work with it and perhaps 
a few other things. Then it will return to the if statement a value of true or false, 
f not. 

Assuming the if statement evaluates to true, the program runs this bit of code (also 
from step 2): 

for(int i = 1; i <= currentLevel; i++) { 
currentscore = currentscore + i; 

} 


currentLevel++ ; 

The code enters a for loop where the starting variable i is initialized to 1 like this: 
int i = l . Furthermore, the loop is instructed to continue as long as i is less than 
or equal to our currentLevel variable. Then within the for loop, we add i to the 
current score. As an example, let's assume that the player has just got a question 
correct and we enter the for loop with currentLevel at 1. The player's score is still 
at 0 because this is their first correct answer. 
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At pass 1, we get the following: 

• i = 1, SO it is equal to currentLevel, which is also 1. So we enter the for 
loop 

• i = 1, SO currentScore equals 0 

• We add i, which is 1, to currentScore 

• Our currentScore variable is now equal to 1 

At pass 2, the following steps take place: 

• i is incremented to 2, so it is now greater than currentLevel, which is 1 

• The for loop condition evaluates to false and we continue with the code 
after the for loop 

• currentLevel is increased by 1 to 2 

Now let's look at that for loop again assuming that the player gets the next question 
correct as well, and we are back in updateScoreAndLevel. This time, isCorrect has 
evaluated true and we enter the for loop but with a slightly different situation than 
the last time. 

At pass 1, the following steps take place: 

• i = 1, so i is less than currentLevel is 2 and we enter the for loop 

• i = 1, currentScore = 1 

• We add i, which is equal to 1, to currentScore 

• Our currentScore variable is now equal to 2 

At pass 2, we have the following steps happening: 

• i is incremented to 2 and it is now equal to currentLevel, which is also 2 

• i = 2 , currentScore = 2 

• We add i, which is now equal to 2, to currentScore 

• Our currentScore variable is now equal to 4 

At pass 3, the following steps take place: 

• i is incremented to 3 and it is now greater than currentLevel, which is 2. 

• The for loop condition evaluates to false and we continue with the code after 
the for loop. 

• The value of currentLevel is increased by 1 to 3. So the next time, we will 
have an extra pass through our for loop. 
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What is happening is that with each level, the player is being rewarded with another 
pass through the for loop, and each pass through the for loop adds a greater value to 
their score. To summarize what happens in the for loop, here is a brief table of values 
showing how the player's score is increased based on the currentLevel variable: 


currentLevel 

Added to currentScore 

currentScore after for loop 

1 

1 

1 

2 

3 (1 + 2) 

4 

3 

6 (1 + 2 + 3) 

10 

4 

10 (1 + 2 + 3 + 4) 

20 

5 

15 (1 + 2 + 3 + 4 + 5) 

35 



Of course, we could have kept it really simple and not used a for 
loop. We could just use currentScore = currentScore + level 
perhaps, but that doesn't offer an ever increasing reward in the same 
way as our current solution does and we wouldn't have been able to 
practice our for loops either. 


If if (isCorrect (answerGiven) ) evaluates to false, it simply resets the score to 0 
score and the 

level using the variables we have just discussed. 

Now we have just one more method to write. Of course, this is the isCorrect 
method, which we just called. 


The isCorrect method 

This method is nice and simple because we have seen all of the relevant code before, 
k at carefully: 

1. Enter the code just after the closing brace of the updateScoreAndLevel 
method but before the closing brace of the GameActivity class. Type the 
method signature like this: 

boolean isCorrect ( int answerGiven) { 
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2. Here we can see that the method must return a Boolean value, true or false, 
we 

use this method as the evaluation expression in the updateScoreAndLevel 
method, we will definitely get a result. It can be true or false. The signature 
also shows us the answerGiven variable passed in, ready for us to use. Type 
this code, which will determine that result: 

boolean correctTrueOrFalse; 
if (answerGiven == correctAnswer ) { //YAY ! 

Toast . makeText (getApplicationContext () , "Well done!", 

Toast . LENGTH_LONG ) . show ( ) ; 
correctTrueOrFalse=true ; 

}else{//Uh-oh! 

Toast . makeText (getApplicationContext ( ) , "Sorry", 

Toast . LENGTH_LONG ) . show ( ) ; 
correctTrueOrFalse=f alse ; 

} 

3. We have seen almost all of the preceding code before. The exception is that we 
declare a Boolean variable, correctTrueOrFalse, which we assign to true if 
the player answers correctly and to false if not. We know whether the player 
is correct or not because we compare answerGiven to correctAnswer in the 
if statement. Notice that we have also triggered the appropriate Android 
pop-up toast message as we did before. Finally, we do this: 

return correctTrueOrFalse; 

} 

We just returned whatever value is contained within correctTrueOrFalse. So the 
critical if statement in updateScoreAndLevel, which we discussed in detail, will 
know what to do next. 

To make sure we understand what is happening in isCorrect, let's go through the 
We see that 

we will return a true or false value and receive int. 

In step 2, we declare a Boolean variable called correctTrueOrFalse to hold 
with 

if (answerGiven == correctAnswer) . If the two compared values match, a 
congratulatory message pops up and we assign true to our Boolean variable. Of 
course, if the if statement is false, we offer commiserations to the player and assign 
false to our important Boolean. 
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Finally in step 3, we send back true or false so that the updateScoreAndLevel 
method can proceed with its work. 

We have now implemented all our methods. It's time to put them to work. 

Calling our new methods 

Of course, our shiny new methods won't do anything until we call them. So here is 
the plan to call these methods: 

1. When the game starts, we want to set a new question for the player. 
Therefore, as the last line of code in our onCreate method, we can call 
our setQuestion method like this: 

setQuestion ( ) ; 

} //onCreate ends here 

2. Then we turn our attention to the onClick method, which already detects 
which button has been pressed and loads the player's answer into our 
answerGiven variable. So at the end of the onClick method, after the 
closing brace of the switch statement, we just call this function: 
updateScoreAndLevel (answerGiven) ; 

3. This sends our player's attempted answer to updateScoreAndLevel, which 
evaluates the answer using isCorrect, adds points, and increments the score 
we need 

now is another question. Add this line. It will ask another question: 

setQuestion ( ) ; 

So now what happens is that the player starts our math game by clicking on its icon 
on their Android device. Our GameActivity class declares a few variables that we 
need access to throughout: 

int correctAnswer ; 

Button buttonObj ectChoicel ; 

Button buttonObj ectChoice2 ; 

Button buttonObj ectChoice3 ; 

TextView textObj ectPartA; 

TextView textObj ectPartB ; 

TextView textOb j ectScore ; 

TextView textOb j ectLevel ; 

int currentScore = 0; 
int currentLevel = 1; 
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Then onCreate initializes some variables and gets our buttons ready to receive 
clicks from the player before asking the first question by calling setQuestion. The 
game then waits for the player to attempt an answer. When the player attempts an 
answer, it is dealt with by onClick, updateScoreAndLevel, and isCorrect. Then 
the program control comes back to onClick again, setQuestion is called again, and 
we wait for the player's answer once more. 

Finishing touches 

soon. The project has served its purpose to demonstrate some fundamentals of 
Java programming as well as some key Android features. Now we need to start 
introducing some more game-related topics. 

more cool 
will see 

how that can be implemented when we look at our next game project in Chapter 5, 
Gaming and Java Essentials. You will then have enough information to easily come 
back and implement high scores on your own. 

playable 
ore based on 
tricks up 
d respond 

to time in Chapter 5, Gaming and Java Essentials, when we talk about threads. 

Now we will quickly learn two improvements: 

• Locking the screen orientation 

• Changing the home screen image 

Going full screen and locking orientation 

You might have noticed that if you rotate your device while the app is running, 
ost. What 

goes wrong is that when the device is rotated, the onPause and onStop methods are 
e onPause 

the screen 

to rotate anyway, so if we stop it we solve two problems in one. 
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While adding code to this file. Android Studio may try to "help" by adding extra 
formatting. If you get red error indicators, you can compare your AndroidManif est . 
xml file with the one in the code download in the Chapter4 /MathGameChapter4 
folder. Alternatively, you can simply replace the contents of your file with the 
contents of the file in the download. The step-by-step changes are detailed in this 
guide just to highlight what is changing: 

1. This is the first step in locking the app to portrait. Open the 
AndroidManif est .xml file. It is located directly below the res folder 
in the Project Explorer. Find the first opening < activity in the code. 

2. Enter a new line as follows: 

android : screenOrientation= "portrait " 

3. Repeat step 2 after the second instance of <activity. We have now locked 
both the menu and game screens in portrait mode. 

4. To make the game full screen, in the same file, find the following text and 
add the line in bold after it but before the closing > sign: 

<activity 

android : name= " com.packtpub . mathgamechapter4 . app . MainActivit 

y" 

android : label= "@string/ app_name " 

android: theme= "@android: style/Theme . NoTitleBar . Fullscreen" > 
</activity> 

5. Make the same change to the GameActivity activity like this. Again, here is 
the code in context in order to avoid mistakes with these > signs: 

<activity 

android : name= " com.packtpub . mathgamechapter4 . app . GameActivit 

y" 

android : label= "@string/title_activity_game" 

android: theme= "@android: style/Theme . NoTitleBar . Fullscreen" > 
</activity> 

6. Save the project. 

Now, when you rotate the device during gameplay, the portrait orientation will 
be fixed. 
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Adding a custom image (instead of the 
Android icon) 

We probably don't want to have the Android image on our finished game home 
n you having 

an image you would like to use: 

1. First, we need to add the required image to the layout folder. Copy your 
image file by clicking on it in Windows Explorer and using Ctrl + C. 

2. Now find the drawable-mdpi folder in the Android Studio Project Explorer. 
Click on the folder. 

3. Paste the image to the folder using Ctrl + V. 

4. Now the image is a part of our project. We simply need to choose it in 
the same way as we chose the image of the Android robot previously. 

Open activity_main . xml in the editor window and click on ImageView 
(currently an Android robot). 

5. In the Properties window, find the src property. Click on it and then on .... 

6. Search for your image and select it. 

7. Save your project. 

8. You now have the image of your choice on the home screen. 

Self-test questions 

Ql) Guess what is wrong with this method: 

void doSomething ( ) { 
return 4 ; 

} 


Q2) What will x be equal to at the end of this code snippet? 

int x=19; 
do{ 

x=ll ; 
x++ ; 

}while (x<2 0 ) 
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Summary 

ava loops 

and took your first, fairly deep look into Java methods and how to use them. You 
learned how to generate random numbers and significantly enhanced your math 
game using all of the knowledge you gained. 

. In the 

next chapter, we will make a game to test the player's memory. It will have sound, 
animation and will actually save the player's high scores too. 

Congratulations on your progress so far but let's keep going. 
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. We will learn 
t of data 

in an organized and efficient manner, 
more than 

one thing apparently simultaneously. 

If you thought that our math game was a bit on the quiet side, then we will look at 
adding sound effects to our games as well as introducing a cool open source app to 
generate authentic sound effects. 

ns when the 
ns to the 

score then? How will we load the right level the next time they play? 
edge along 

with what we already know to create a neat memory game. 

In this chapter, we will cover the following topics: 

• J ava arrays — an array of variables 

• Timing with threads 

• Creating and using beeps 'n' buzzes — Android sound 

• A look at life after destruction— persistence 

• Building the memory game 



Gaming and Java Essentials 

Java arrays - an array of variables 

You might be wondering what happens when we have a game with lots of variables 
to keep track of. How about a table of high scores with the top 100 scores? We could 
declare and initialize 100 separate variables like this: 

int topScorel; 
int topScore2 ; 
int topScore3; 

//96 more lines like the above 
int topScorelOO; 

ne gets 
ne place? 

A nightmare begins: 

topScorelOO = topScore99; 
topScore99 = topScore98; 
topScore98 = topScore97; 

//96 more lines like the above 
topScorel = score; 

There must be a better way to update the scores. When we have a large set of variables, 
what we need is a Java array. An array is a reference variable that holds up to a fixed 
maximum number of elements. Each element is a variable with a consistent type. 

The following line of code declares an array that can hold int type variables, even a 
high score table perhaps: 

int [] intArray; 

We can also declare arrays of other types, like this: 

String [] classNames; 
boolean [] bankOf Switches ; 
float [] closingBalancesInMarch; 

Each of these arrays would need to have a fixed maximum amount of storage space 
allocated before it is used, like this: 

intArray = new int [10 0] ; 
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The preceding line of code allocates up to a maximum of 100 integer-sized storage 
spaces. Think of a long aisle of 100 consecutive storage spaces in our variable 
warehouse. The spaces would probably be labeled int Array [ 0 ] , int Array [ 1 ] , 
intArray [2] , and so on, with each space holding a single int value. Perhaps the 
slightly surprising thing here is that the storage spaces start off at 0, not 1. Therefore, 
in an array of size 100, the storage spaces would run from 0 to 99. 

We can actually initialize some of these storage spaces like this: 

intArray [0] = 5; 
intArray [1] = 6; 
intArray [2] = 7; 

Note that we can only put the declared type into an array and the type that an array 
holds can never change: 

intArray [3 ]= "John Carmack" ; //Won ' t compile 

So when we have an array of int types, what are each of the int variables called? 
The array notation syntax replaces the name. We can do anything with a variable in 
an array that we could do with a regular variable with a name: 

intArray [3] = 123; 


les: 


intArray[10] = intArray[9] - intArray [4] ; 

me type, 
like this: 

int myNamedlnt = intArray [3] ; 

Note, however, that myNamedlnt is a separate and distinct primitive variable, so any 
changes made to it do not affect the value stored in the intArray reference. It has its 
own space in the warehouse and is not connected to the array. 

Arrays are objects 

as an address 
aiogy, 

someArray is an aisle number. So each of someArray [0] , someArray [1] , and 
so on is the aisle number followed by the position number in the aisle. 
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Arrays are also objects. This means that they have methods and properties that we 
can use: 

int lengthOf SomeArray = someArray . length; 

In the previous line of code, we assigned the length of someArray to the int variable 
called lengthOf SomeArray. 

f its elements, 

stores another array, like this: 

String!] [] countriesAndCities ; 
ry. Let's not 

go array-crazy just yet. Just remember that an array holds up to a predetermined 
sed using 
this syntax: 

someArray [someLocation] ; 

use them in 

real code and what we might use them for. 

A simple example of an array 

Let's write a really simple working example of an array by performing the following 
e code 

bundle. It's at Chapter5/SimpleArrayExample/MainActivity. java: 

1. Create a project with a blank activity, just as we did in Chapter 2, Getting 
Started with Android. Also, clean up the code by deleting the unnecessary 
parts, but this isn't essential. 

2. First, we declare our array, allocate five spaces, and initialize some values to 
each of the elements: 

//Declaring an array 
int [] ourArray; 

/ /Allocate memory for a maximum size of 5 elements 
ourArray = new int [5] ; 

//Initialize ourArray with values 

//The values are arbitrary as long as they are int 
//The indexes are not arbitrary 0 through 4 or crash! 

ourArray [ 0 ] = 25; 
ourArray [1] = 50; 
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ourArray[2] = 12 5; 
ourArray[3] = 68; 
ourArray[4] = 47; 

3. We output each of the values to the logcat console. Notice that when we add 
s fine 
a 

compiler treats the lines as one statement: 

//Output all the stored values 


Log . i 

" info" , 

"Here 

is ourArray : " ) ; 

Log . i 

" info" , 

" [0] = 

"+ourArray [0] ) ; 

Log . i 

" info" , 

" [1] = 

" +ourArray [1] ) ; 

Log . i 

" info" , 

" [2] = 

"+ourArray [2] ) ; 

Log . i 

" info" , 

" [3] = 

"+ourArray [3] ) ; 

Log . i 

" info" , 

" [4] = 

"+ourArray [4] ) ; 


//We can do any calculation with an array element 
//As long as it is appropriate to the contained type 
//Like this: 

int answer = ourArray[0] + 
ourArray [ 1 ] + 
ourArray[2] + 
ourArray [3] + 
ourArray [4] ; 

Log . i ( " inf o" , "Answer = "+ answer); 

4. Run the example on an emulator. 

Remember that nothing will happen on the emulator display because the entire 
output will be sent to our logcat console window in Android Studio. Here is the 
output of the preceding code: 

info: Here is ourArray: 

info: [0] = 25 

info: [1] = 50 

info: [2] = 125 

info: [3] = 68 

info: [4] = 47 

info: Answer = 315 

In step 2, we declared an array called ourArray to hold int variables, and allocated 
space for up to five variables of that type. 
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Next, we assigned a value to each of the five spaces in our array. Remember that the 
first space is ourArray [0] and the last space is ourArray [4] . 

sole. From the 

output, we can see that they hold the value we initialized in the previous step. Then 
we added each of the elements in ourArray and initialized their value to the answer 
variable. We then printed answer to the console and saw that all the values where 
added together, just as if they were plain old int types stored in a slightly different 
manner, which is exactly what they are. 

Getting dynamic with arrays 

declare 
amount of 

benefit in an array over regular variables. Let's look at an example of declaring and 
initializing arrays dynamically. 

Dynamic array example 

ps. You can 

fi Chapter5/ 

DynamicArrayExample/MainActivity . j ava: 

1. Create a project with a blank activity, just as we did in Chapter 2, Getting 
Started with Android. Also, clean up the code by deleting the unnecessary 
parts, but this isn't essential. 

2. Type the following between the opening and closing curly braces of 
onCreate. See if you can work out what the output will be before we 
discuss it and analyze the code: 

//Declaring and allocating in one step 
int [] ourArray = new int [1000] ; 

//Let's initialize ourArray using a for loop 
//Because more than a few variables is allot of typing! 
for(int i = 0; i < 1000; i + + ) { 

//Put the value of ourValue into our array 
//At the position determined by i. 
ourArray [i] = i*5; 

//Output what is going on 
Log . i (" info" , "i = " + i); 

Log . i (" info" , "ourArray[i] = " + ourArray [i] ) ; 

} 
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3. Run the example on an emulator. Remember that nothing will happen on the 
emulator display because the entire output will be sent to our logcat console 
window in Android Studio. Here is the output of the preceding code: 
info: i = 0 
info: ourArrayti] = 0 
info: i = 1 
info: ourArrayti] = 5 
info: i = 2 

info: ourArrayti] = 10 

I have removed 994 iterations of the loop for brevity: 

info: ourArrayti] = 4985 

info: i = 998 

info: ourArrayti] = 4990 

info: i = 999 

info: ourArrayti] = 4995 

All the action happened in step 2. We declared and allocated an array called ourArray 
to hold up to 1,000 int values. This time, however, we did the two steps in one line 
of code: 

int [] ourArray = new int [1000] ; 

Then we used a for loop that was set to loop 1,000 times: 

(int i = 0; i < 1000; i++) { 

We initialized the spaces in the array from 0 to 999 with the value of i multiplied 
by 5, as follows: 

ourArray [i] = i*5; 

To demonstrate the value of i and the value held in each position of the array, we 
output the value of i followed by the value held in the corresponding position in 
the array as follows: 

Log . i ( " inf o" , "i = " + i); 

Log . i ( " inf o" , "ourArrayti] = " + ourArrayti]); 

All of this happened 1,000 times, producing the output we saw. 
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Entering the nth dimension with arrays 

We very briefly mentioned that an array can even hold other arrays at each of its 
positions. Now, if an array holds lots of arrays that hold lots of some other type, 
how do we access the values in the contained arrays? And why would we ever 
nal 

arrays can be useful. 


An example of a multidimensional array 

Let's g 

steps. You can find the working project for this example in the download bundle. 
It is at Chapter5/MultidimensionalArrayExample/MainActivity . j ava: 

1. Create a project with a blank activity, just as we did in Chapter 2, Getting 
Started with Android. Also, clean up the code by deleting the unnecessary 
methods, but this isn't essential. 

2. After the call to setContentview, declare and initialize a two-dimensional 
array, like this: 

//A Random object for generating question numbers later 
Random randlnt = new Random ( ) ; 

//And a variable to hold the random value generated 
int questionNumber ; 

//We declare and allocate in separate stages for clarity 
/ /but we don ' t have to 
String[] [] countriesAndCities; 

//Here we have a 2 dimensional array 

//Specifically 5 arrays with 2 elements each 
//Perfect for 5 "What's the capital city" questions 
countriesAndCities = new String [5] [2] ; 


//Now we load the questions and answers into our arrays 
//You could do this with less questions to save typing 
//But don't do more or you will get an exception 
countriesAndCities [0] [0] = "United Kingdom"; 
countriesAndCities [0] [1] = "London"; 


countriesAndCities [1] [0] 
countriesAndCities [1] [1] 


"USA" ; 

"Washington" ; 


countriesAndCities [2] [0] 


" India" ; 
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countriesAndCities [2] [1] = "New Delhi"; 

countriesAndCities [3] [0] = "Brazil"; 

countriesAndCities [3] [1] = "Brasilia"; 

countriesAndCities [4] [0] = "Kenya"; 

countriesAndCities [4] [1] = "Nairobi"; 

3. Now we output the contents of the array using a for loop and a Random class 
always pick the correct answer: 

//Now we know that the country is stored at element 0 

//The matching capital at element 1 

//Here are two variables that reflect this 

int country = 0; 

int capital = 1; 

//A quick for loop to ask 3 questions 

for (int i = 0; i < 3; i++){ 

/ /get a random question number between 0 and 4 
questionNumber = randlnt . nextlnt ( 5 ) ; 

//and ask the question and in this case just 
//give the answer for the sake of brevity 
Log . i ( " inf o" , "The capital of " 

+countriesAndCities [questionNumber] [country] ) ; 

Log . i (" info" , "is " 

+countriesAndCities [questionNumber] [capital] ) ; 

}//end of for loop 

Run the example on an emulator. Once again, nothing will happen on the emulator 
display because the output will be sent to our logcat console window in Android 
Studio. Here is the output of the previous code: 

info: The capital of USA 
info: is Washington 
info: The capital of India 
info: is New Delhi 

info: The capital of United Kingdom 
info: is London 
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What just happened? Let's go through this chunk by chunk so that we know exactly 
what is going on. 

We make a new object of the Random type, called randlnt, ready to generate random 
numbers later in the program: 

Random randlnt = new Random ( ) ; 

We declare a simple int variable to hold a question number: 

int questionNumber ; 

Then we declare countriesAndCities, our array of arrays. The outer array 
holds arrays: 

String [] [] countriesAndCities; 

Now we allocate space within our arrays. The first outer array will be able to hold 
fi 


countriesAndCities = new String [5] [2] ; 

capital cities. 

Notice that with each pair of initializations, the outer array number stays the same, 
indicating that each country/ capital pair is within one inner array (a string array), 
r array (which 
holds arrays): 


countriesAndCities 

[0] 

[0] 

= "United Kingdom 

countriesAndCities 

[0] 

[1] 

= "London"; 

countriesAndCities 

[1] 

[0] 

= "USA"; 

countriesAndCities 

[1] 

[1] 

= "Washington" ; 

countriesAndCities 

[2] 

[0] 

= "India"; 

countriesAndCities 

[2] 

[1] 

= "New Delhi"; 

countriesAndCities 

[3] 

[0] 

= "Brazil"; 

countriesAndCities 

[3] 

[1] 

= "Brasilia"; 

countriesAndCities 

[4] 

[0] 

= "Kenya" ; 

countriesAndCities 

[4] 

[1] 

= "Nairobi"; 
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To make the upcoming for loop clearer, we declare and initialize int variables to 
represent the country and the capital from our arrays. If you glance back at the array 
initialization, all the countries are held in position o of the inner array and all the 
corresponding capital cities are held at position l: 

int country = 0; 
int capital = 1; 

Now we create a for loop that will run three times. Note that this number does not 
mean we access the first three elements of our array. It is rather the number of times 
es, but the 

example would still work: 

for (int i = 0; i < 3; i++){ 

Next, we actually determine which question to ask, or more specifically, which 
element of our outer array. Remember that randlnt . next Int ( 5 ) returns a number 
h five 

elements, from 0 to 4: 

questionNumber = randlnt . nextlnt ( 5 ) ; 

Now we can ask a question by outputting the strings held in the inner array, 
which in turn is held by the outer array that was chosen in the previous line 
by the randomly generated number: 

Log . i ( " inf o" , "The capital of " 

+countriesAndCities [questionNumber] [country] ) ; 

Log . i ( " inf o" , "is " 

+countriesAndCities [questionNumber] [capital] ) ; 

}//end of for loop 

rest of this 
inside arrays, 

then that doesn't matter. You know they exist and what they can do, so you can 
revisit them if necessary. 
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Array-out-of-bounds exceptions 

merit of 

an array that does not exist. Whenever we try this, we get an error. Sometimes, the 
compiler will catch it to prevent the error from going into a working game, like this: 

int [] ourArray = new int [1000] ; 
int someValue = 1 ; //Arbitrary value 

ourArray [1000] = someValue ; //Won ' t compile as compiler knows this 
won ' t work . 

//Only locations 0 through 999 are valid 

Guess what happens if we write something like this: 

int [] ourArray = new int [1000] ; 
int someValue = 1 ; //Arbitrary value 
int x = 999; 
if (userDoesSomething) { 
x++;//x now equals 1000 

} 

ourArray [x] = someValue; 

//Array out of bounds exception if userDoesSomething evaluates to 
true! This is because we end up referencing position 1000 when the 
array only has positions 0 through 999 

//Compiler can't spot it and game will crash on player - yuck! 

that arrays 

start at zero and go up to the number obtained by subtracting one from the allocated 
e what we 

have done and spot the problems. 

Timing with threads 

So what is a thread? You can think of threads in Java programming just like threads 
in a story. In one thread of a story, we have the primary character battling the enemy 
on the front line, and in another thread, the soldier's family are getting by, day to 
day. Of course, a story doesn't have to have just two threads. We could introduce a 
ry commanders 

making decisions. These decisions subtly, or not so subtly, affect what happens in the 
other threads. 
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• They make sense from an organizational point of view 

• They are a proven way of structuring a program that works 

• The nature of the system we are working on forces us to use them 

In Android, we use threads for all of these reasons simultaneously. It makes sense, it 
works, and we have to use it because of the design of the system. 

In gaming, think about a thread that receives the player's button taps for "left", 
"right", and "shoot", a thread that represents the alien thinking where to move next, 
and yet another thread that draws all the graphics on the screen. 

story, if 
soldier 

went into battle before the battle or even the war existed? Weird! 

What if we have a variable, int x, that represents a key piece of data that say three 

ad of 

problem 

of correctness, caused by multiple threads racing to completion, oblivious of each 
other —because they are just dumb code after all. 

The problem of correctness can be solved by close oversight of the threads and 

locking 

that things are working in a synchronized manner. It's like freezing the soldier from 
has been 

lowered, avoiding an embarrassing splash. 

deadlock, 

access x, 

a halt. 

You might have noticed that it was the solution to the first problem (correctness) that 
is the cause of the second problem (deadlock). Now consider all that we have just 
possible that 

you start to feel a little nauseous with the complexity. 

Fortunately, the problem has been solved for us. Just as we use the Activity class 
and override its methods to interact with the Android lifecycle, we can also use other 
classes to create and manage our threads. Just as with Activity, we only need to 
know how to use them, not how they work. 
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you would 
erent and is 
va code 

to create and work within our threads if we can do the following: 

• Accept that the new concepts we will introduce are what we need to work 
with in order to create an Android-specific solution to the problems related 
to working with threads 

• Understand the general concept of a thread, which is mostly the same as a 
story thread that happens almost simultaneously 

• Learn the few rules of using some of the Android thread classes 

d classes work 
ds in Android. 

e Handler. 

In Chapter 7, Retro Squash Game, and Chapter 8, The Snake Game, we will use the 
Runnable class. All we need to remember is that we will be writing parts of our 
program that run at almost the same time as each other. 

What do I mean by "almost"? What is actually happening is 
that the CPU switches between threads in turn. However, this 
happens so fast that we will not be able to perceive anything 
but simultaneity. 

A simple thread timer example with the 
Handler class 

breads are not 

as complicated as first feared. When using threads in a real game, we will have to 
t's not much, 

and we will talk about it when we get to it. 

As usual, you can simply use the complete code from the download bundle. 

This project is located in Chapters/ SimpleThreadTimer/MainActivity . java. 
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ure in a lot 
of games: 

1. Create a project with a blank activity, just as we did in Chapter 2, Getting 
Started with Android. Also, clean up the code by deleting the unnecessary 
parts, but this isn't essential. 

2. Immediately after the class declaration, enter the three highlighted lines: 

public class MainActivity extends Activity { 

private Handler myHandler; 
boolean gameOn; 
long startTime; 

3. Enter this code inside the onCreate method. It will create a thread with 
something else going on in the if (gameOn) block: 

//How many milliseconds is it since the UNIX epoch 
startTime = System. currentTimeMillis () ; 

myHandler = new Handler () { 

public void handleMessage (Message msg) { 
super . handleMessage (msg) ; 

if (gameOn) { 

long seconds = ( (System. currentTimeMillis ( ) - 

startTime)) / 1000; 

Log . i (" info" , "seconds = " + seconds); 

} 


myHandler . sendEmptyMessageDelayed ( 0 , 1000) ; 


gameOn = true ; 

myHandler. sendEmptyMessage (0) ; 

} 

4. Run the app. Quit with the home or back button on the emulator. Notice that 
we 

implement our memory game. 
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When you run the example on an emulator, remember that nothing will happen 
on the emulator display because all of the output will be sent to our logcat console 
window in Android Studio. Here is the output of the previous code: 

info: seconds = 1 
info: seconds = 2 
info: seconds = 3 
info: seconds = 4 
info: seconds = 5 
info: seconds = 6 

So what just happened? After 1-second intervals, the number of seconds elapsed was 
printed to the console. Let's learn how this happened. 

First, we declare a new object, called myHandler, of the Handler type. We then 
declare a Boolean variable called gameOn. We will use this to keep track of when our 
variable of the 

long type. You might remember the long type from Chapter 3, Speaking Java - Your 
First Game. We can use long variables to store very large whole numbers, and this is 
what we do here with startTime: 

private Handler myHandler; 
boolean gameOn; 
long startTime; 

Next, we initialized startTime using currentTimeMillis, a method of the System 
class. This method holds the number of milliseconds since January 1, 1970. We will 
see how we use this value in the next line of code. 

startTime = System. currentTimeMillis () ; 

Next is the important code. Everything up to if (gameOn) marks the code to define 
bad as it looks at 
fit need to 

understand every aspect of how they do their work. 

Let's dissect the preceding code to demystify it a bit. The myHandler = new 
Handler ( ) line simply initializes our myHandler object. What is different from what 
afterwards. 

We override the handleMessage method (which is where we put our code that 
runs in the thread) and then we call super . handleMessage, which calls the default 
version of handleMessage before it runs our custom code. This is much like we do 
for the onCreate method every time we call super . onCreate. 
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Then we have the if (gameOn) block. Everything in that if block is the code that we 
want to run in the thread. The if (gameOn) block simply gives us a way to control 
whether we want to run our code at all. For example, we might want the thread up 
and running but only sometimes run our code. The if statement gives us the power 
appening in 
the if block later: 

myHandler = new Handler () { 

public void handleMessage (Message msg) { 
super . handleMessage (msg) ; 

if (gameOn) { 

long seconds = ( (System. currentTimeMillis ( ) - 
startTime) ) / 1000; 

Log. i ( "info" , "seconds = " + seconds); 

} 

myHandler . sendEmptyMessageDelayed ( 0 , 1000) ; 

} 


}; 


Inside the if block, we declare and initialize another long variable called seconds, 
and do a little bit of math with it: 

long seconds = ( (System. currentTimeMillis ( ) - startTime)) / 1000; 

and then 

subtract startTime from it. This gives us the number of milliseconds since we 
first initialized startTime. Then we divide the answer by 1000 and get a value 
in seconds. We print this value to the console with the following line: 

Log. i ( "info" , "seconds = " + seconds) ; 

Next, just after our if block, we have this line: 

myHandler . sendEmptyMessageDelayed ( 0 , 1000) ; 

in the 

handleMessage method once every 1000 milliseconds (once a second). 

Back in onCreate, after the closing curly braces of the handleMessage method and 
the Handler class, we finally set gameOn to true so that it is possible to run the code 
in the if block: 

gameOn = true; 
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Then, this last line of the code starts the flow of messages between our thread and the 
Android system: 

myHandler . sendEmptyMessage ( 0 ) ; 

It is worth pointing out that the code inside the if block can be as minimal or as 
extensive as we need. When we implement our memory game, we will see much 
more code in our if block. 

just seen 

allows us to run the contents of the if block in a new thread. That's it! Perhaps 
apart from brushing over that System class a bit quickly. 

The System class has many uses. In this case, we use it to get the 
number of milliseconds since January 1, 1970. This is a common system 
used to measure time in a computer. It is known as Unix time, and the 
first millisecond of January 1, 1970, is known as the Unix Epoch. We 
will bump into this concept a few more times throughout the book. 

Enough on threads, let's make some noise! 

Beeps n buzzes - Android sound 

This section get 
on with it. 

Creating sound FX 

Years ago, whenever I made a game, I would spend many hours trawling websites 
ere, the 
y are never 
p called 

Bfxr, and I have never wasted another moment looking for sound effects since. We 
can make our own. 

rab a free 

copy of Bfxr from www . bfxr . net. 
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examples to make cool sound effects: 


Chapter 5 


This is a seriously condensed tutorial. You can do much more 
with Bfxr. To learn more, read the tips on the website at the 
previous URL. 

1. Runbfxr.exe: 




[ 165 ] 



Gaming and Java Essentials 


2. Try out all the preset types, which generate a random sound of that type. 
When you have a sound that is close to what you want, move to the next step: 


Pickup/Coin 


Laser/Shoot 


Explosion 


Powerup 


Hit/Hurt 


Jump 


Blip/Select 


Randomize 


Mutation 


3. Use the sliders to fine-tune the pitch, duration, and other aspects of your 
new sound: 
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4. Save your sound by clicking on the Export Wav button. Despite the name of 
this button, as we will see, we can save in formats other than . wav. 


Export Wav 


5. Android likes to work with sounds in the OGG format, so when asked to 
name your file, use the . ogg extension on the end of whatever you decide 
to call it. 

6. Repeat steps 2 to 5 as often as required. 

Every project in this book that requires sound samples comes with 
the sound samples provided, but as we have seen, it is much more 
fun to make our own samples. All you need to do is to save them 
with the same filename as the provided samples. 



Playing sounds in Android 

in the . ogg 

format. So if you don't have them to hand, go back to the Creating sound FX section 
to make some. Alternatively, you can use the sounds provided in the chapters/ 
PlayingSounds/assets folder of the code bundle. As usual, you can view or use the 
already completed code at Chapter5/PlayingSounds/java/MainActivity . java 
and Chapter5/PlayingSounds/layout/activity_main.xml. Now perform the 
following steps: 

1. Create a project with a blank activity, just as we did in Chapter 2, Getting 
Started with Android. Also, clean up the code by deleting the unnecessary 
parts, although this isn't essential. 

2. Create three sound files and save them as samplel . ogg, sample2 . ogg, and 
sample3 . ogg. 

3. In the main folder in the Project Explorer window, we need to add a folder 
called assets. So in the Project Explorer window, right-click on the main 
folder and navigate to New | Directory. Type assets in the New Directory 
dialog box. 

4. Now copy and paste the three sound files to the newly created assets folder. 
Alternatively, select the three files, right-click on them, and click on Copy. 
Then click on the assets folder in the Android Studio Project Explorer. Now 
right-click on the assets folder and click on Paste. 
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5. Open activity_main . xml in the editor window and drag three button 
widgets onto your UI. It doesn't matter where they are or how they are 
aligned. When you look at the id property in the Properties window for any 
of our three new buttons, you will notice that they have automatically been 
assigned id properties. They are button, button2, and button3. As we will 
see, this is just what we need. 

6. Let's enable our activity to listen to the buttons being clicked by implementing 
onClickListener as we have done in all our other examples with buttons. 
Open MainActivity.java in the editor window. Replace the public class 
MainActivity extends Activity { line with the following line of code: 
public class MainActivity extends Activity implements View. 

OnClickListener { 

7. As before, we get an unsightly red underline on our new line of code. The 
last time this happened, we typed in the empty body of the onClick method 
that we must implement and all was well. This time, because we already 
know what is going on here, we will learn a shortcut. Hover your mouse 
cursor over the error and right-click on it. Now click on Generate... and then 
select Implement methods.... In the Select Methods To Implement dialog 
box, onClick(View):void will already be selected: 



8. Select this option by clicking on OK. Now scroll to the bottom of your code 
and see that Android Studio has very kindly implemented the onClick 
method for you and the error is also gone. 
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9. Type this code after the MainActivity declaration to declare some variables 
for our sound effects: 

private SoundPool soundPool ; 
int samplel = -1; 
int sample2 = -1; 
int sample3 = -1; 

10. Type this code in the onCreate method to load our sounds into memory: 
soundPool = new SoundPool ( 10 , AudioManager . STREAM_MUSIC, 0 ) ; 

try { 

//Create objects of the 2 required classes 

AssetManager assetManager = getAssetsO; 
AssetFileDescriptor descriptor; 

/ /create our three fx in memory ready for use 
descriptor = assetManager . openFd (" samplel . ogg" ) ; 
samplel = soundPool . load (descriptor , 0) ; 

descriptor = assetManager . openFd (" sample2 . ogg" ) ; 
sample2 = soundPool . load (descriptor , 0) ; 


descriptor = assetManager . openFd (" sample3 . ogg" ) ; 
sample3 = soundPool . load (descriptor , 0) ; 


} catch ( IOException e) { 

//catch exceptions here 

} 

11. Now add the code to grab a reference to the buttons in our UI and listen to 
clicks on them: 

/ /Make a button from each of the buttons in our layout 
Button buttonl = (Button) findViewByld (R . id . button) ; 

Button button2 = (Button) findViewByld (R . id . button2 ) ; 

Button button3 = (Button) findViewByld (R . id . button3 ) ; 

//Make each of them listen for clicks 
buttonl . setOnClickListener (this) ; 
button2 . setOnClickListener (this) ; 
button3 . setOnClickListener (this) ; 
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12. Finally, type this code in the onClick method that we autogenerated: 

switch (view. getld ( ) ) { 


case R . id . button : //when the first button is pressed 
//Play sample 1 

soundPool .play (samplel, 1, 1, 0, 0, 1) ; 
break ; 


/ /Now the other buttons 
case R . id . button2 : 

soundPool .play (sample2 , 1, 1, 0, 0, 1) ; 
break ; 

case R . id . button3 : 

soundPool .play (sample3 , 1, 1, 0, 0, 1) ; 
break ; 

} 


by clicking 

on a button, you can play any of your three sound samples at will. Of course, sounds 
ey can be 

played from a thread as well. We will see more sound samples when we implement 
the memory game later in the chapter. 

n the usual 

way. In steps 2 to 5, however, we created some sounds with Bfxr, created an assets 
folder, and placed the files within it. This is the folder where Android expects to find 
sound fid files, 

the Android system will be able to find them. 

In steps 6 to 8, we enabled our activity to listen to button clicks as we have done 
ate the 

onClick method. 

Then we saw this code: 

private SoundPool soundPool ; 

First, we create an object of the SoundPool type, called soundPool. This object will be 
e: 


int 

samplel = 

-l; 

int 

sample2 = 

-l; 

int 

sample3 = 

-l; 
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The preceding code is very simple; we declared three int variables. However, 
they serve a slightly deeper purpose than a regular int variable. As we will see in 
to a sound 

file that is loaded into memory. In other words, the Android system will assign a 
ound file 
will reside. 

the 

name of the int variable, and contained within it is what Android needs to find 
our sound. Here is how we load our sounds into memory and use the references 
we've just been discussing. 

then we will 

examine what is going on: 

soundPool = new SoundPool ( 10 , AudioManager . STREAM_MUSIC, 0 ) ; 

Here, we initialize our soundPool object and request up to 10 simultaneous streams 
nd every 

time. AudioManager . STREAM_MUSIC describes the type of stream. This is typical for 
applications of this type. Finally, the o argument indicates we would like default 
quality sound. 

into 

two blocks, try and catch. This means that if the code in the try block fails, we 
want the code in the catch block to run. As you can see, there is nothing but a 
comment in the catch block. 

We must do this because of the way the SoundPool class is designed. If you try to 
write the code without the try and catch blocks, it won't work. This is typical of 
Java classes involved in reading from files. It is a fail-safe process to check whether 
the fio output 

to the console that an error has occurred. 

If you want to experiment with try/ catch, then put a line of code 
to output a message in the catch block and remove one of the sound 
fi 

and the code in the catch block will be triggered. 
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We will throw caution to the wind because we are quite sure that the files will be 
there and will work . Let's examine what is inside the try block. Take a close look 
at the following code and then we will dissect it: 

try { 

//Create objects of the 2 required classes 

AssetManager assetManager = getAssetsO; 
AssetFileDescriptor descriptor; 

//create our three fx in memory ready for use 
descriptor = assetManager . openFd (" samplel . ogg" ) ; 
sample! = soundPool . load (descriptor , 0) ; 

descriptor = assetManager . openFd (" sample2 . ogg" ) ; 
sample2 = soundPool . load (descriptor , 0) ; 


descriptor = assetManager . openFd (" sample3 . ogg" ) ; 
sample3 = soundPool . load (descriptor , 0) ; 


} catch ( IOException e) { 

//catch exceptions here 

} 


First, we create an object called assetManager of the AssetManager type and an 
AssetFileDescriptor object called descriptor. We then use these two objects 
combined to load our first sound sample like this: 

descriptor = assetManager . openFd (" samplel . ogg" ) ; 
samplel = soundPool . load (descriptor , 0) ; 

We now have a sound sample loaded in memory and its location saved in our int 
variable called samplel. The first sound file, samplel . ogg, is now ready to use. We 
perform the same procedure for sample2 and sample3 and we are ready to make 
some noise! 

re. In step 
ng upon 

which button is pressed. You can probably see that the single action each button 
takes is the playing of a sound. For example, Buttonl does this: 

soundPool .play (samplel , 1, 1, 0, 0, 1) ; 
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This line of code plays the sound that is loaded in memory at the location referred to 
by int samplel. 



The arguments of the method from left to right define the 
following: the sample to play, left volume, right volume, priority 
over other playing sounds, loop or not, rate of playback. You 
can have some fun with these if you like. Try setting the loop 
argument to 3 and the rate argument to perhaps 1.5. 


Life after destruction - persistence 

en making 

games. You have probably noticed that the slightest thing can reset our math game, 
such as an incoming phone call, a battery that ran flat, or even tilting the device to a 
different orientation. 

ate 

place as 

they left off. If you were using a word-processing app, you would definitely 
expect this type of behavior. 

We are not going to go to that extent with our game, but as a bare minimum, 
ething 

to aim for, and most importantly, a reason to come back to our game. 

An example of persistence 

, from 

reading and writing to files to setting up and using whole databases through our 
pies in 

this book is by using the SharedPref erences class. 

In this example, we will use the SharedPref erences class to save data. Actually, we 
will be reading and writing to files, but the class hides all of the complexity from us 
and allows us to focus on the game. 
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miliar with 

the code before we use something similar to save the high score in our memory 
game. The complete code for this example can be found in the code bundle at 
Chapter5/Persistence/ j ava/MainActivity . j ava and Chapter 5 /Persistence/ 
layout / activity_main . xml: 

1. Create a project with a blank activity, just as we did in Chapter 2, Getting 
Started with Android. Also, clean up the code by deleting the unnecessary 
parts, but this isn't essential. 

2. Open activity_main . xml in the editor window and click and drag one 
button from the palette to the design. The default ID of the button that is 
assigned is perfect for our uses, so no further work is required on the UI. 

3. Open MainActivity . j ava in the editor window. Implement view . 
onClickListener and autogenerate the required onClick method, just as 
we did in steps 6 and 7 of the Playing sound in Android example previously. 

4. Type the following code just after the MainActivity declaration. This declares 
our two objects that will do all the complex stuff behind the scenes: a bunch of 
strings that will be useful and a button: 

SharedPref erences prefs; 

SharedPref erences . Editor editor; 

String dataName = "MyData" ; 

String stringName = "MyString" ; 

String defaultstring = 

String currentstring = ""///empty 
Button buttonl; 

5. Add the next block of code to the onCreate method after the call 

to setContentview. We initialize our objects and set up our button. 

We will look closely at this code once the example is done: 

//initialize our two SharedPref erences objects 
prefs = getSharedPref erences (dataName , MODE_PRIVATE) ; 
editor = pref s . edit () ; 

//Either load our string or 

//if not available our default string 

currentstring = pref s . getstring ( stringName , defaultstring); 

/ /Make a button from the button in our layout 
buttonl = (Button) findViewByld (R . id . button) ; 

/ /Make each it listen for clicks 
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buttonl . setOnClickListener (this) ; 

//load currentstring to the button 
buttonl . setText (currentstring) ; 

6. Now the action takes place in our onClick method. Add this code, which 
generates a random number and adds it to the end of currentstring. Then 
it saves the string and sets the value of the string to the button as well: 

//we don't need to switch here! 

//There is only one button 

//so only the code that actually does stuff 

//Get a random number between 0 and 9 

Random randlnt = new Random ( ) ; 

int ourRandom = randlnt . next Int (10 ) ; 

//Add the random number to the end of currentstring 
currentstring = currentstring + ourRandom; 

//Save currentstring to a file in case the user 
//suddenly quits or gets a phone call 
editor . putString ( stringName , currentstring) ; 
editor . commit ( ) ; 

//update the button text 
buttonl . setText (currentstring) ; 


ess 

the button, a random number is appended to the text of the button. Now quit 
app, 

our cool SharedPreferences class simply loads the last saved string. 

es before 
until step 4: 

SharedPreferences prefs; 

SharedPreferences . Editor editor; 
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Here, we declare two types of SharedPreferences objects called pref s and editor. 
We will see exactly how we use them in a minute. 

Next, we declare the dataName and stringName strings. We do this because to use 
the facilities of SharedPreferences, we need to refer to our collection of data, as well 
as any individual pieces of data within it, using a consistent name. By initializing 
dataName and stringName, we can use them as a name for our data store as well as 
a specific item within that data store, respectively. The sad face in defaultstring 
gets used any time the SharedPreferences object needs a default because either 
nothing has been previously saved or the loading process fails for some reason. The 
currentstring variable will hold the value of the string we will be saving and loading 
as well as displaying to the user of our app. Our button is buttoni: 


String dataName = "MyData"; 

String stringName = "MyString"; 
String defaultstring = 

String currentstring = " " ; / /empty 
Button buttoni; 


In step 5, the real action starts with this code: 

prefs = getSharedPref erences (dataName, MODE_PRIVATE) ; 
editor = pref s . edit (); 


currentstring = pref s . getString (stringName , defaultstring); 

The previous code does stuff that would take a lot more code if we didn't have 
the useful SharedPreferences class. The first two lines initialize the objects and 
the third loads the value from our data store item, whose name is contained in 
stringName, to our currentstring variable. The first time this happens, it uses the 
defaultstring value because nothing is stored there yet, but once there is a value 
stored, this single line of code that will load up our saved string. 
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fore. 

Moving on to step 6 in the ondick method, there is no switch block because there 

re are the first 

three lines from ondick: 

Random randlnt = new Random ( ) ; 

int ourRandom = randlnt . nextlnt ( 10 ) ; 

currentstring = currentstring + ourRandom; 

We generate a random number and append it to the currentstring variable. Next, 
still in ondick, we do this: 

editor . putString ( stringName , currentstring) ; 
editor . commit ( ) ; 

This is like the opposite of the code that loaded our string in onCreate. The first 
of the previous two lines identifies the place in the data store to write the value to 
(stringName) and the value to be written there (currentstring). The next line, 
editor . commit ( ) ;, simply says, "go ahead and do it." 

The following line displays currentstring as text on our button so that we can see 
what is going on: 

buttonl . setText (currentstring) ; 

For more on persistence, take a look at the second 
question of the Self- test questions section at the end 
of this chapter. 


The memory game 

The code in the memory game shouldn't challenge us too much because we have 
done the background research on threads, arrays, sound, and persistence. There will 
up. 
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Here is a screenshot of our finished game: 
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play 

sessions and when the device is shut down. It also shows a Play button, which will 
take the player to the main game screen. Take a look at the following screenshot: 
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The game screen itself will play a sequence of sounds and numbers. The 
corresponding button will wobble in time with the corresponding sound. Then the 
player will be able to interact with the buttons and attempt to copy the sequence. For 
every part of the sequence that the player gets right, they will be awarded points. 

e will be 

played and again the player will attempt to repeat the sequence. This continues until 
the player gets a part of a sequence wrong. 

As the score increases, it is displayed in the relevant TextView, and when a sequence 
is copied correctly, the level is increased and displayed below the score. 

The player can start a new game by pressing the Replay button. If a high score is 
achieved, it will be saved to a file and displayed on the home screen. 

The implementation of the game is divided into five phases. The end of a phase 
would be a good place to take a break. Here are the different phases of the game: 

• Phase 1: This implements the UI and some basics. 

• Phase 2 

to the player. 

• Phase 3: In this phase, we will handle the player's response when they try to 
copy the pattern. 

• Phase 4: Here, we will use what we just learned about persistence to maintain 
the player's high score when they quit the game or turn off their device. 

• Phase 5: At the end of phase 4, we will have a fully working memory game. 
However, to add to our repertoire of Android skills, after we have discussed 
Android UI animations near the end of this chapter, we will complete this 
phase, which will enhance our memory game. 

All the files containing the complete code and the sound files after all five stages 
can be found in the download bundle in the Chapters /MemoryGame folder. In this 
f the stages. 

Phase 1 - the UI and the basics 

Here, we will lay out a home menu screen UI and a UI for the game itself. We will 
also configure some IDs for some of the UI elements so that we can control them in 
our Java code later: 

1. Create a new application called Memory Game and clean up the code if 
you wish. 
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2. Now we create a new activity and call it GameActivity. So right-click on the 
j ava folder in Project Explorer, navigate to New | Activity, then click on 
Next, name the activity as GameActivity, and click on Finish. For clarity, 
clean up this activity in the same way as we cleaned up all our others. 

3. Make the game fullscreen and lock the orientation as we did in the Going 
fullscreen and locking orientation tutorial at the end of Chapter 4, Discovering 
Loops and Methods. 

4. Open the activity_main . xml file from the res /layout folder. 


1. Open activity_main . xml in the editor and delete the Hello World TextView. 

2. Click and drag the following: Large Text to the top center (to create our title 
text). Image just below that, another LargeText below that (for our high 
score), and a Button (for our player to click to play). Your UI should look a 
bit like what is shown in the following screenshot: 




Memory Game 


ft 


Hi Score: 99' 

9 


c2b 

E==P 
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3. Adjust the text properties of the two TextViews and the Button element 
to make it plain what each will be used for. As usual, you can replace the 
Android icon in the ImageView with any image you choose (as we did in 
Chapter 4, Discovering Loops and Methods, in the Adding a custom image tutorial). 

4. Tweak the sizes of the elements in the usual way to suit the emulator or 
device you will be running the game on. 

5. Let's make the ID for our Hi Score TextView more relevant to its purpose. 
Left-click to select the Hi Score TextView, find its id property in the 
Properties window, and change it to textHiScore. The IDs of the image and 
the title are not required, and the existing ID of the play button is button. 


Let's wire up the Play button to create a link between the home and the game 
screens, as follows: 

1. Open MainActivity. java in the editor. 

2. Add implements View . onClickListener to the end of the MainActivity 
declaration so that it now looks like this: 

public class MainActivity extends Activity implements 
View. OnClickListener { 

3. Now hover your mouse over the line you just typed and right-click on it. 
Now click on Generate, then on Implement methods..., and then on OK to 
have Android Studio autogenerate the onClick method we must implement. 

4. At the end of our onCreate method, before the closing curly brace, enter the 
following code to get a reference to our Play button and listen to clicks: 

//Make a button from the button in our layout 
Button button = (Button) findViewByld (R . id . button) ; 

/ /Make each it listen for clicks 
button. setOnClickListener (this) ; 

5. Scroll down to our onClick method and enter the following code in its body 
to have the Play button take the player to our GameActivity, which we will 
design soon: 

Intent i ; 

i = new Intent (this, GameActivity. class) ; 
startActivity (i) ; 
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At this point, the app will run and the player can click on the Play button to take 
them to our game screen. So let's quickly create our game screen UI: 

1. Open activity_game . xml in the editor and delete the Hello World TextView. 

2. Drag three Large Text elements one below the other and center them 
er, 

and finally, add another button below that but offset it to the right-hand side 

adjusted 

be 

work for 
t the 

emulator or device you will be running the game on. 




Score: 999 


Difficulty: 4 


Watch/Go 
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3. Now let's assign some useful IDs to our UI elements so that we can do some 
Java magic with them in the next tutorial. Here is a table that matches the UI 
elements shown in the last screenshot with the id property value that you 
need to assign. Assign the following id property values to the corresponding 
UI elements: 


Purpose 

Default id property 

New id to assign 

Score indicator 

textView 

textScore 

Difficulty indicator 

textView2 

textDifficulty 

Watch/ go indicator 

textView3 

textWatchGo 

Button 1 

button 

Leave at default 

Button 2 

button2 

Leave at default 

Button 3 

button3 

Leave at default 

Button 4 

button4 

Leave at default 

Replay button 

button5 

buttonReplay 


art to 

make it work. 

Phase 2 - preparing our variables and 
presenting the pattern 

, both in this 
ode that 

present a pattern to the player. We will add code that enables the player to respond 
in a later phase: 

1. Open GameActivity. java in the editor window. 

2. I made the sounds by finding a pleasing one then slowly increasing the 
Frequency slider for each subsequent sample. You can use my sound from the 
assets folder in the MemoryGame project or create your own sound using Bfxr. 

3. In the main folder in the project explorer window, we need to add a folder 
called assets. So in the project explorer window, right-click on the main 
folder and navigate to New | Directory. Type assets in the New Directory 
dialog box. 

4. Now copy and paste the four sound files to the newly created assets folder. 
You can do so like this: select the files, right-click on them, and then click 

on Copy. Then click on the assets folder in the Android Studio project 
explorer. Now right-click on the assets folder and click on Paste. 
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Let's prepare GameActivity to listen to button clicks just as we did for 
MainActivity, as follows: 

1. Add implementsView . onClickListener to the end of the GameActivity 
declaration so that it now looks like this: 

public class GameActivity extends Activity implements 
View. OnClickListener { 

2. Now hover your mouse over the line you just typed and right-click on it. Now 
click on Generate, then on Implement methods..., and then on OK to have 
Android Studio autogenerate the onClick method that we will use shortly. 

3. Let's declare some objects that we need to reference our UI and our int 
references for the sound effects we will load soon. Write the code just after the 
declaration for GameActivity. By putting them here, they will be available to 
all parts of our code in GameActivity . j ava. Here is the code in context: 

public class GameActivity extends Activity implements 
View . OnClickListener { 

//Prepare objects and sound references 

//initialize sound variables 
private SoundPool soundPool ; 
int samplel = -1; 
int sample2 = -1; 
int sample3 = -1; 
int sample4 = -1; 

//for our UI 
TextView textScore; 

TextView textDif f iculty; 

TextView textWatchGo; 

Button buttonl ; 

Button button2 ; 

Button button3 ; 

Button button4 ; 

Button buttonReplay ; 
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4. Now, after the last line of code from the previous step, enter the following code 
snippet, which will declare and initialize some variables for use in our thread. 
Notice that at the end, we also declare myHandler, which will be our thread, 
and gameOn to control whether our code within the thread is executed: 

//Some variables for our thread 
int dif f icultyLevel = 3; 

//An array to hold the randomly generated sequence 
int [] sequenceToCopy = new int [100] ; 

private Handler myHandler; 

//Are we playing a sequence at the moment? 
boolean playSequence = false; 

//And which element of the sequence are we on 
int elementToPlay = 0; 

//For checking the players answer 
int playerResponses ; 
int playerScore; 
boolean isResponding; 

5. Just after our call to setContentView in the onCreate method, we make our 
sound effects ready to be played: 

soundPool = new SoundPool ( 10 , AudioManager . STREAM_MUSIC, 0 ) ; 
try { 

//Create objects of the 2 required classes 
AssetManager assetManager = getAssetsO; 

AssetFileDescriptor descriptor; 

//create our three fx in memory ready for use 
descriptor = assetManager . openFd (" samplel . ogg" ) ; 
samplel = soundPool . load (descriptor , 0) ; 

descriptor = assetManager . openFd (" sample2 . ogg" ) ; 
sample2 = soundPool . load (descriptor , 0) ; 


descriptor = assetManager . openFd (" sample3 . ogg" ) ; 
sample3 = soundPool . load (descriptor , 0) ; 

descriptor = assetManager . openFd (" sample4 . ogg" ) ; 
sample4 = soundPool . load (descriptor , 0) ; 


} catch (IOException e) { 

//catch exceptions here 

} 
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6. Just after the code in the last step and still within the onCreate method, we 
initialize our objects and set click listeners for the buttons: 

//Reference all the elements of our UI 

//First the TextViews 

textScore = (TextView) findViewByld (R. id. textScore) ; 
textScore . setText (" Score : " + playerScore) ; 

textDif f iculty = (TextView) findViewByld (R. id. textDiff iculty) ; 

textDif f iculty. setText ( "Level : " + diff icultyLevel) ; 
textWatchGo = (TextView) findViewByld (R . id . textWatchGo) ; 

//Now the buttons 

buttonl = (Button) findViewByld (R . id . button) ; 
button2 = (Button) findViewByld (R . id . button2 ) ; 
button3 = (Button) findViewByld (R . id . button3 ) ; 
button4 = (Button) findViewByld (R . id . button4 ) ; 
buttonReplay = (Button) findViewByld (R . id . buttonReplay) ; 

//Now set all the buttons to listen for clicks 

buttonl . setOnClickListener (this) ; 

button2 . setOnClickListener (this) ; 

button3 . setOnClickListener (this) ; 

button4 . setOnClickListener (this) ; 

buttonReplay. setOnClickListener (this) ; 

7. Now, after the last line of the code from the previous step, enter the code 
thin 

the if (playSequence) block. Notice that the thread is run every nine-tenths 
of a second (900 milliseconds). Notice that we start the thread but do not set 
playSequence to true. So it will not do anything yet: 

//This is the code which will define our thread 
myHandler = new Handler () { 

public void handleMessage (Message msg) { 
super . handleMessage (msg) ; 

if (playSequence) { 

//All the thread action will go here 

} 


myHandler . sendEmptyMessageDelayed ( 0 , 900) ; 
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};//end of thread 

myHandler . sendEmptyMessage ( 0 ) ; 

8. Before we look at the code that will run in our thread, we need a way to 

generate a random sequence appropriate for the difficulty level. This situation 
sounds like a candidate for a method. Enter this method just before the closing 
curly brace of the GameActivity class: 
public void createSequence ( ) { 

//For choosing a random button 
Random randlnt = new Random ( ) ; 
int ourRandom; 

for(int i = 0; i < dif f icultyLevel ; i++) { 

//get a random number between 1 and 4 
ourRandom = randlnt . nextlnt (4 ) ; 
ourRandom ++;//make sure it is not zero 
/ /Save that number to our array 
sequenceToCopy [i] = ourRandom; 


} 

} 

9. We also need a method to prepare and start our thread. Type the following 
method after the closing curly brace of createSequence: 




Actually, the order of implementation of the methods is 
unimportant. However, following along in order will mean 
our code will look the same. Even if you are referring to the 
downloaded code, the order will be the same. 


public void playASequence ( ) { 
createSequence!) ; 
isResponding = false; 
elementToPlay = 0; 
playerResponses = 0; 
textWatchGo . setText ( "WATCH ! " ) ; 
playSequence = true; 
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10. Just before we look at the details of the thread code, we need a method to 
hod 

after the closing curly brace of playASequence: 
public void sequenceFinished ( ) { 
playSequence = false; 

//make sure all the buttons are made visible 
buttonl . setVisibility (View. VISIBLE) ; 
button2 . setVisibility (View. VISIBLE) ; 
button3 . setVisibility (View . VISIBLE) ; 
button4 . setVisibility (View. VISIBLE) ; 
textWatchGo . setText ( "GO ! " ) ; 
isResponding = true; 

} 

11. Finally, we will implement our thread. There is some new code in this 
part, which we will go through in detail after we finish this phase of the 
the 

if (playSequence) { } block: 
if (playSequence) { 

//All the thread action will go here 
//make sure all the buttons are made visible 
buttonl . setVisibility (View. VISIBLE) ; 
button2 . setVisibility (View. VISIBLE) ; 
button3 . setVisibility (View. VISIBLE) ; 
button4 . setVisibility (View . VISIBLE) ; 

switch (sequenceToCopy [elementToPlay] ) { 
case 1 : 

//hide a button 

buttonl . setVisibility (View . INVISIBLE) ; 

/ /play a sound 

soundPool .play (samplel, 1, 1, 0, 0, In- 
break; 

case 2 : 

//hide a button 

button2 . setVisibility (View . INVISIBLE) 

//play a sound 

soundPool . play ( sample2 , 1, 1, 0, 0, 1) ; 
break ; 

case 3 : 

//hide a button button3 . setVisibility (View. INVISIBLE) ; 
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//play a sound 

soundPool .play (sample3 , 1 , 1, 0, 0, In- 
break; 

case 4 : 

//hide a button 

button4 . setVisibility (View . INVISIBLE) ; 

//play a sound 

soundPool . play ( sample4 , 1, 1, 0, 0, In- 
break; 

} 

elementToPlay++ ; 

if (elementToPlay == diff icultyLevel) { 
sequenceFinished ( ) ; 

} 


myHandler . sendEmptyMessageDelayed ( 0 , 900) ; 

} 



Just before the closing curly brace of onCreate, we could initiate a 
sequence by calling our playASequence method, like this: 
playASequence ( ) ; 

We could then run our app, click on Play on the home screen, and 
watch as a sequence of four random buttons and their matching 
sounds begins, with the sounds being played. In the next phase, 
we will wire up the Replay button so that the player can start the 
sequence when they are ready. 


did cram 

in just about everything we ever learned about Java and Android into one place, and 
extra focus to 

the parts that might seem tricky. 

Let's look at each new piece of code in turn, 
loaded our 

sounds as we have done before. We also put in the outline of the code for our thread. 
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In step 8, we implemented the createSequence method. We used a Random object 
a for 

loop, which loops until a sequence the length of dif f icultyLevel has been created. 
The sequence is stored in an array called sequenceToCopy, which we can later use to 
compare to the player's response: 

public void createSequence () { 

//For choosing a random button 
Random randlnt = new Random ( ) ; 
int ourRandom; 

for(int i = 0; i < dif f icultyLevel ; i++) { 

//get a random number between 1 and 4 
ourRandom = randlnt . nextlnt (4 ) ; 
ourRandom ++;//make sure it is not zero 
/ / Save that number to our array 
sequenceToCopy [i] = ourRandom; 

} 


In step 9, we implemented playASequence. First, we call createSequence to 
load our sequenceToCopy array. Then we set isResponding to false because 
we don't want the player to bash buttons while the sequence is still playing. 

We set elementToPlay to o as this is the first element of our array. We also set 
playerResponses to 0, ready to count the player's responses. Next, we set some 
text on the UI to "watch ! " to make it clear to the player that the sequence is playing. 
Finally, we set playSequence to true, which allows the code in our thread to run 
once every 900 milliseconds. Here is the code we have just analyzed: 

public void playASequence () { 
createSequence ( ) ; 
isResponding = false; 
elementToPlay = 0; 
playerResponses = 0; 
textWatchGo . setText ( "WATCH !"); 
playSequence = true; 

} 
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In step 10, we handle sequenceFinished. We set playSequence to false, which 

k to visible 

emphasize 

which button comes next in the sequence. We set our UI text to GO! to make it 
ode in the 

checkElement method to run, we set isResponding to true. We will look at the 
code in the checkElement method in the next phase: 

public void sequenceFinished () { 
playSequence = false; 

/ /make sure all the buttons are made visible 
buttonl . setVisibility (View. VISIBLE) ; 
button2 . setVisibility (View. VISIBLE) ; 
button3 . setVisibility (View. VISIBLE) ; 
button4 . setVisibility (View. VISIBLE) ; 
textWatchGo . setText ( "GO ! " ) ; 
isResponding = true; 

} 

ated. First, 
one of them is 

currently invisible and setting just that one: 

if (playSequence) { 

//All the thread action will go here 
//make sure all the buttons are made visible 
buttonl . setVisibility (View . VISIBLE) ; 
button2 . setVisibility (View . VISIBLE) ; 
button3 . setVisibility (View . VISIBLE) ; 
button4 . setVisibility (View . VISIBLE) ; 

propriate 

button, and play the appropriate sound. Here is the first case in the switch block 
a different 

button and with a different sound: 

switch (sequenceToCopy [elementToPlay] ) { 
case 1 : 

//hide a button 

buttonl . setVisibility (View. INVISIBLE) ; 

//play a sound 

soundPool .play (samplel, 1, 1, 0, 0, in- 
break; 

//case 2, 3 and go here 

} 
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Now we increment elementToPlay, ready to play the next part of the sequence 
when the thread runs again in approximately 900 milliseconds: 

elementToPlay++ ; 

we have, 

we call our sequenceFinished method to set things up for the player to attempt 
their answer: 

if (elementToPlay == diff icultyLevel) { 
sequenceFinished ( ) ; 

} 

} 


Finally, we tell the thread when we would like to run our code again: 

myHandler . sendEmptyMessageDelayed ( 0 , 900) ; 

} 


When you ran a sequence (see the previous tip), did you notice an imperfection/ bug 
with our game operation? This has to do with the way the last element of the sequence 
is animated. It is because our sequenceFinished method makes all the buttons visible 
so soon after the button has just been made invisible that looks like the button is never 
made invisible at all. We will solve the problem of the button that doesn't stay invisible 
long enough when we learn about UI animation in phase 5. 

Now let's handle the player's response. 

Phase 3 - the player's response 

We now have an app that plays a random sequence of button flashes and matching 
now is enable 

the player to attempt to replicate the sequence and score points if successful. 

presses, 

e. 
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y examine the 
less obvious parts: 

1. Here is how we handle the button presses. We have the empty body of the 
switch statement with an extra if statement that checks whether there is 
is 

accepted. We will start to fill the code in the empty body in the next step: 

if ( IplaySequence) {//only accept input if sequence not playing 
switch (view.getld ( ) ) { 

//case statements here... 

} 

} 


2. Now, here is the code that handles buttoni. Notice that it just plays the 
sound related to buttoni and then calls the checkElement method, passing 

ya 

sound and then tell our new method (checkElement) which numbered 
button was pressed, and checkElement will do the rest: 

case R. id. button: 

//play a sound 

soundPool .play (samplel, 1, 1, 0, 0, 1) ; 
checkElement (In- 
break; 

3. Here is the near-identical code for buttons 2 through 4. Notice that the value 
passed to checkElement and the sound sample that is played are the only 
differences from the previous step. Enter this code directly after the code in 
the previous step: 

case R . id . button2 : 

//play a sound 

soundPool .play (sample2 , 1, 1, 0, 0, 1) ; 

checkElement (2) ; 

break; 

case R . id . button3 : 

//play a sound 

soundPool .play (sample3 , 1, 1, 0, 0, 1) ; 

checkElement (in- 
break; 

case R . id . button4 : 

//play a sound 

soundPool .play (sample4 , 1, 1, 0, 0, 1) ; 

checkElement (in- 
break; 
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4. Here is the last part of the code in our ondick method. This handles the 
Restart button. The code just resets the score and the difficulty level and then 
calls our playASequence method, which does the rest of the work of starting 
step: 

case R. id.buttonReplay: 
dif f icultyLevel = 3; 
playerScore = 0 ; 

textScore . setText ( "Score : " + playerScore); 

playASequence ( ) ; 

break; 

5. Finally, here is our do-everything method. This is quite a long method 
compared to most of our previous methods, but it helps to see its entire 
structure. We will break this down line by line in a minute. Enter the following 
code, after which you will actually be able to play the game and get a score: 
public void checkElement ( int thisElement) { 

if (isResponding) { 
playerResponses++ ; 

if (sequenceToCopy [playerResponses-1] == thisElement) { // 
Correct 

playerScore = playerScore + ((thisElement +1) * 2) ; 
textScore . setText ( "Score : " + playerScore); 
if (playerResponses == dif f icultyLevel ) {//got the whole 
sequence 

//don't checkElement anymore 
isResponding = false; 

//now raise the difficulty 
dif f icultyLevel ++ ; 

//and play another sequence 
playASequence ( ) ; 

} 


} else {//wrong answer 

textWatchGo . setText ( " FAILED ! " ) ; 
//don't checkElement anymore 
isResponding = false; 

} 

} 


We covered the methods fairly comprehensively as we went through the tutorial. 
The one elephant in the room, however, is the apparent sprawl of code in the 
checkElement method. So let's go through all of the code in step 6, line by line. 
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First, we have the method signature. Notice that it does not return a value but it 
receives an int value. Remember that it is the ondick method that calls this method 
and it passes a l, 2, 3, or 4, depending upon which button was clicked: 

public void checkElement ( int thisElement) { 

Next, we wrap the rest of this code into an if statement. Here is the if statement. 

We enter the block when the isResponding Boolean is true, and isResponding is 
set to true when the sequenceFinnished method completes, which is just what we 
need so that the player can't mash the buttons until it is time to do so and our game 
is ready to listen: 

if (isResponding) { 

Here is what happens inside the if block. We increment the number of the player's 
responses received in the playerResponses variable: 

playerResponses++ ; 

Now we check whether the number passed to the checkElement method and stored 
in thisElement matches the appropriate part of the sequence the player is trying to 
copy. If it matches, we increase playerScore by an amount relative to the number of 
correctly matched parts of the sequence so far. Then we set the score on the screen. 
Notice that if the response does not match, there is an else block to go with this if 
block that we will explain soon: 

if (sequenceToCopy [playerResponses -1] == thisElement) { //Correct 
playerScore = playerScore + ( (thisElement +1) * 2) ; 
textScore . setText (" Score : " + playerScore); 


Next, we have another if block. Note that this if block is nested inside the if 
block we just described. So it will only be tested and potentially run if the player's 
response was correct. This if statement checks whether it is the last part of the 
sequence, like this: 

if (playerResponses == diff icultyLevel) { 


//got the whole sequence 

//don't checkElement anymore 
isResponding = false; 

//now raise the difficulty 
diff icultyLevel ++ ; 

/ /and play another sequence 
playASequence ( ) ; 
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What is happening inside the nested if statement, which checks whether the whole 
sequence has been correctly copied, is the following: It sets isResponding to false, 
so the player gets no response from the buttons. It then raises the difficulty level by 
1 so that the sequence is a bit tougher next time. Finally, it calls the playSequence 
method to play another sequence and the whole process starts again. 

Here is the else block, which runs if the player gets part of the sequence wrong: 

} else { 

/ /wrong answer 

textWatchGo . setText ( " FAILED !"); 

//don't checkElement anymore 
isResponding = false; 

} 

} 

Here, we set some text on the screen and set isResponding to false. 

Now let's use what we learned about the SharedPref erences class to preserve the 
high scores. 

Phase 4 - preserving the high score 

chapter to 
best score in 

the hi-score TextView in our MainActivity: 

1. Open MainActivity. java in the editor window. 

2. Then we declare our objects used to read from a file just after the class 
declaration, like this: 

public class MainActivity extends Activity implements View. 
OnClickListener { 

//for our hiscore (phase 4) 

SharedPref erences prefs; 

String dataName = "MyData" ; 

String intName = "MyString" ; 
int defaultlnt = 0; 

//both activities can see this 
public static int hiScore; 
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3. Now, just after our call to setContentView in the onCreate method, we 
initialize our objects, read from our file, and set the result to our hi Score 
variable. We then display it to the player: 

//for our high score (phase 4) 

//initialize our two SharedPref erences objects 
prefs = getSharedPref erences (dataName, MODE_PRIVATE) ; 

/ /Either load our High score or 

//if not available our default of 0 

hiScore = prefs . getlnt ( intName , defaultlnt); 

/ /Make a reference to the Hiscore textview in our layout 
TextView textHiScore = (Textview) findViewByld (R . id . textHiScore) ; 
//Display the hi score 
textHiScore . setText ( "Hi : "+ hiscore); 

4. Next, we need to go back to the GameActivity . j ava file. 

5. We declare our objects to edit our file, this time like this: 

//for our hiscore (phase 4) 

SharedPref erences prefs; 

SharedPref erences . Editor editor ; 

String dataName = "MyData"; 

String intName = "Mylnt"; 
int defaultlnt = 0; 
int hiScore; 

6. Just after the call to setContentView in the onCreate method, we instantiate 
our objects and assign a value to hiscore: 

//phase 4 

//initialize our two SharedPref erences objects 
prefs = getSharedPref erences (dataName, MODE_PRIVATE) ; 
editor = pref s . edit ( ) ; 

hiScore = pref s . getlnt ( intName , defaultlnt); 
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7. The only thing that is different to what we have already learned is that we 
need to consider where we put the code to test for a high score and where to 
write to our file if appropriate. Consider this: eventually, every player must 
fail. Furthermore, the point at which they fail is the point when their score is 
at its highest, yet before it is reset when they try again. Place the following 
code in the else block, which handles a wrong answer from the player. The 
highlighted code is the new code; the rest is there to help you with the context: 

} else {//wrong answer 

textWatchGo . setText ( " FAILED !"); 

//don't checkElement anymore 
isResponding = false; 

//for our high score (phase 4) 
if (playerScore > hiScore) { 
hiScore = playerScore; 

editor .putlnt (intName, hiScore); 
editor . commit ( ) ; 

Toast .makeText (getApplicationContext () , "New Hi- 
score" , Toast . LENGTH_LONG) .show() ; 

} 


Play the game and get a high score. Now quit the app or even restart the phone. 
When you come back to the app, your high score is still there. 

The code we added in this phase is nearly the same as the code we wrote in our 
to the data 
essed. In 

addition, we used the editor . putlnt method because we were saving an integer 
instead of editor . putstring when we were saving a string. 
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Animating our game 

Before we go ahead, let's just think about animation. What is it exactly? The word 
racters 

of a video game. 

they are 
eappear 

was inadequate, 
gine 

complex for loops and per-pixel calculations. 

Fortunately, Android provides us with the Animation class, which allows us to 
t works. 



Of course, to fully control the shape and size of in-game objects, 
we must eventually learn to manipulate individual pixels and 
lines. We will do so from Chapter 7, Retro Squash Game, onwards, 
when we make a retro pong-style squash game. 


Ul animation in Android 

Animations in the Android UI can be divided into three phases: 

• Describing the animation in a file using a special syntax we will see shortly 

• Referencing that animation by creating an object of it in our Java code 

• Applying the animation to a UI element when the animation is required 
to run 

be reusing 

this same code in our memory game. The purpose of showing it is not so much that 
be enough 
s to 
our 

games using the same Java. 

We can quickly search the Web to find the code to perform the following: 

• Fading in and out 

• Sliding 

• Rotating 
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• Expanding or shrinking 

• Morphing color 

Here is some code that causes a wobble effect. We will use it on a button, but you can 
also use it on any UI element or even the whole screen: 

<?xml version= " 1 . 0 " encoding= "utf - 8 " ? > 

•crotate xmlns : android= "http : / / schemas . android . com/ apk / res/android" 
android : duration= " 100 " 
android: f romDegrees= " -5" 
android : pivotX= " 50% " 
android : pivotY= " 50% " 
android : repeatCount= " 8 " 
android: repeatMode=" reverse" 
android : toDegrees= " 5 " /> 

The first line simply states that this is a file written in XML format. The next states 
that we will be performing a rotation. Then we state that the duration will be 100 
the x and y 

axes by 50 percent, repeat eight times, and reverse to positive 5 degrees. 

This is quite a mouthful, but the point is that it is easy to grab a template that works 
and then customize it to fit our situation. We could save the preceding code with a 
filename like wobble . xml. 

Then we could simply reference it as follows: 

Animation wobble = AnimationUtils . loadAnimation (this , R. anim. wobble ) ; 

case our 
buttonl object: 

buttonl . startAnimation (wobble) ; 

Phase 5 - animating the UI 

Let's add an animation that causes a button to wobble when a button sound is 
nvisible 

and the code that makes it reappear. That wasn't the best way to do it, but it served 
a purpose while developing the game: 

1. We need to add a new folder to our project, called anim. So right-click on 
the res folder in the Project Explorer window. Navigate to New | Android 
resource directory and click on OK to create the new anim folder. 
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2. Now right-click on the anim folder and navigate to New | Animation 
resource file. Enter wobble in the File name field and click on OK. 

We now have a new file called wobble.xml open in the editor window. 

3. Replace all but the first line of wobble . xml with this code: 

<?xml version= " 1 . 0 " encoding= "utf - 8 " ? > 

<rotate xmlns : android= "http : //schemas . android.com/ apk/ res /android" 
android: duration= " 100 " 
android: f romDegrees= " - 5 " 
android : pivotX= " 5 0% " 
android:pivotY="50%" 
android: repeatCount= " 8 " 
android : repeatMode= " reverse " 
android: toDegrees=" 5" /> 

4. Now switch to GameActivity . java. 

5. Add the following code just after the declaration of our GameActivity class: 
//phase 5 - our animation object 

Animation wobble; 

6. Just after the call to setContentView in our onCreate method, add this piece 
of code: 

//phase5 - animation 

wobble = AnimationUtils . loadAnimation (this , R. anim. wobble ) ; 

7. Now, near the start of our thread code, find the calls to make our buttons 
reappear. Comment them out like this: 

//code not needed as using animations 
//make sure all the buttons are made visible 
/ /buttonl . setVisibility (View. VISIBLE) ; 

/ /button2 . setVisibility (View. VISIBLE) ; 

/ /button3 . setVisibility (View. VISIBLE) ; 

/ /button4 . setVisibility (View . VISIBLE) ; 

8. Next, directly after our code in the previous step, within each of the four 
case statements, we need to comment out the lines that call setVisibility 

!y 

abbreviated but shows exactly where to comment and where to add the 
new lines: 

switch (sequenceToCopy [elementToPlay] ) { 
case 1 : 

//hide a button - not any more 

//buttonl . setVisibility (View. INVISIBLE) ; 
buttonl . startAnimation (wobble) ; 


[ 202 ] 



Chapter 5 


case 2 : 

//hide a button - not any more 

//button2 . setvisibility (View. INVISIBLE) ; 
button2 . startAnimation (wobble) ; 


case 3 : 

//hide a button - not any more 

//button3 . setvisibility (View. INVISIBLE) ; 
button3 . startAnimation (wobble) ; 


case 4 : 

//hide a button - not any more 

//button4 . setvisibility (View. INVISIBLE) ; 
button4 . startAnimation (wobble) ; 


9. Finally, in our sequenceFinished method, we can comment out all the 
setvisibility calls, just as we did in our thread, like this: 

/ /buttonl . setvisibility (View . VISIBLE) ; 

/ /button2 . setvisibility (View . VISIBLE) ; 

/ /button3 . setvisibility (View. VISIBLE) ; 

/ /button4 . setvisibility (View. VISIBLE) ; 

That was not too tough. We added the wobble animation to the anim folder, declared 
required on 
the appropriate button. 

There are obviously loads of improvements we could make to this game, especially 
s was to be 

your app, you were trying to make it big on the Play Store. That is exactly what 
you should do. 

Constantly improve all aspects and strive to be the best in your genre. If you feel the 
urge, then why not improve upon it? 

th some of 

the examples from this chapter. 
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Self-test questions 

Ql) Suppose that we want to have a quiz where the question could be to name the 
nal arrays? 

Q2) In our Persistence example section, we saved a continually updating string to a 
fiThis is like 
of Chapter 

2, Getting Started with Android, can you think of a way to save the string without 
saving it in the button click but just when the user quits the app? 

Q3) Other than increasing the difficulty level, how could we increase the challenge of 
our memory game for our players? 

Q4) Using the plain Android UI with the dull grey buttons isn't very exciting. Take 
w we could 

quickly improve the visual appearance of our UI. 

Summary 

That was a bit of a hefty chapter, but we learned lots of new techniques such as 
and saving 
ief look at 

the powerful but simple-to-use Animation class. 

In the next chapter, we will be taking a more theoretical approach, but we will have 
plenty of working samples too. We will finally be opening the black box of Java 
declare 

and use objects of a class. 
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OOP - Using Other 
People's Hard Work 


OOP stands for object-oriented programming. In this chapter, you don't need to 
even try and remember everything. Why do I say this? Surely, that's what learning is. 
d the why 

of OOP rather than memorize rules, syntax, and jargon. 

The more important thing is to actually start to use some of the concepts, even 
though you might have to keep referring back and your code might not properly 
this book, 
pts of OOP. 

If you try to memorize this chapter, you will have to make a lot of room in your brain, 
and you will probably forget something really important in its place such as going to 
work or thanking the author for telling you not to try and memorize this stuff. 

gnize examples 
then 

often refer back to this chapter for a refresher, 
eady learned 

loads about OOP. Until now, we have been using classes such as Button, Random, 
and Activity, overriding methods of classes (mainly onCreate) and using an 
interface as well; remember implementing onClickListener a few times in the 
first five chapters? 


and finally, we will make our own classes. 



OOP - Using Other People's Hard Work 


cool retro 

arcade games using lots of other people's hard work. This chapter will be mainly 
theory, but with a few practical console examples using LogCat so that we can see 
OOP in action. 

In this chapter, we will do the following: 

• Look at what OOP is. 

• Write our first class. 

• Look at what encapsulation is and how we achieve it as well as look more 
deeply at variables and the different types. We will also take a short break to 
throw out the garbage. 

• Learn about inheritance and how we can extend and even improve upon a 
class before we use it. 

• Take a look at polymorphism, which is a way of being more than one thing at 
a time and is really useful in programming. 


What is OOP? 

into 

chunks that are more manageable than the whole. 

Each chunk is self-contained yet potentially reusable by other programs while 
working together as a whole with the other chunks. 

an object, 

we do so with a class. A class can be thought of as the blueprint of an object. 

We implement an object of a class. This is called an instance of a class. Think about a 
, which means 
a methodology 

that defines best practices such as the following: 

• Encapsulation: This means keeping the internal workings of your code 
the 

variables and methods you choose to be accessed. This means your code can 
way. 

• Inheritance: Just like it sounds, inheritance means we can harness all the 
features and benefits of other people's hard work, including encapsulation 
and polymorphism, while refining their code specifically for our situation. 
Actually, we have done this already every time we used the extends keyword. 
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• Polymorphism: This allows us to write code that is less dependent on 
efficient. Some examples later in the chapter will make this clear. 



When we talk about using other people's hard work, we are not 
talking about a magical way to abuse copyright and get away with it. 
Some code is plain and simple, someone else's property. What we are 
taking about is the vast array of free-to-use code, particularly in the 
context of this book, in the Java and Android APIs. If you want some 
code that does a certain thing, it has probably been done before. We 
just have to find it, then use it or modify it. 


Java was designed from the start with all of this in mind, so we are fairly significantly 
constrained to using OOP. However, this is a good thing because we learn how to use 
the best practices. 


Why do it like this? 

When written properly, all this OOP allows you to add new features without worrying 
as much about how they interact with existing features. When you do have to change 
a class, its self-contained nature means less, or perhaps zero, consequences for other 
parts of the program. This is the encapsulation part. 

ow it 

he Button 

class is quite complicated, with nearly 50 methods — do we really want to write all 
that just for a button? 

OOP allows you to write apps for highly complex situations without breaking a sweat. 
You can create multiple similar yet different versions of a class without starting the 
class from scratch using inheritance, and you can still use the methods intended for 
the original type of object with your new object because of polymorphism. 

Makes sense, really! Let's write some classes and then make some objects out of them. 


Our first class and first object 

So what exactly is a class? A class is a bunch of code that can contain methods, 
a package and 
ys, each 

new class will be defined in its own . j ava code file with the same name as the class. 
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it as 
on the 

blueprint. The house isn't the blueprint just as the object isn't the class; it is an 
object made from the class. 

Here is the code for a class. We call it a class implementation: 

public class Soldier { 
int health; 

String soldierType; 

void shootEnemy ( ) { 

/ /bang bang 

} 


The preceding snippet of code is a class implementation for a class called Soldier. 
There are two variables, an int variable called health and a string variable 
called soldierType. 

There is also a method called shootEnemy. The method has no parameters and a 
void return type, but class methods can be of any shape or size that we discussed 
in Chapter 5, Gaming and Java Essentials. 

When we declare variables in a class, they are known as fields. When the class is 
instantiated into a real object, the fields become variables of the object itself, so we 
call them instance variables. Whichever fancy name they are referred to by, they 
are just variables of the class. However, the difference between fields and variables 
declared in methods (called the local variables) becomes more important as we 
progress. We will look at all types of variables again in the Variables revisited section. 

oldier, not an 

actual soldier object. This is how we make an object of the Soldier type from 
our Soldier class: 

Soldier mySoldier = new Soldier ( ) ; 

In the first part of the code. Soldier mySoldier declares a new reference type 
variable of type Soldier, called mySoldier, and in the last part of the code, new 
Soldier ( ) creates an actual Soldier object. Of course, the assignment operator, =, in 
the middle of the two parts assigns the result of the second part to that of the first. Just 
like regular variables, we could also have performed the preceding steps like this: 


Soldier mySoldier; 
mySoldier = new Soldier ( ) ; 
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This is how we would assign and use the variables: 

mySoldier . health = 100; 
mySoldier . soldierType = "sniper"; 

//Notice that we use the object name mySoldier. 

//Not the class name Soldier. 

//We didn't do this: 

// Soldier .health = 100; ERROR! 

In the preceding code snippet, the dot operator, . , is used to access the variables of 
the class, and this is how we would call the method. Again, we use the object name 
and not the class name, followed by the dot operator: 

mySoldier . shootEnemy ( ) ; 

As a rough guide, a class's methods are what it can do and its 
instance variables are what it knows about itself. 

We can also go ahead by making another Soldier object and accessing its methods 
and variables: 

Soldier mySoldier2 = new Soldier (); 
mySoldier2 . health = 150; 

mySoldier2 . soldierType = "special forces"; 
mySoldier2 . shootEnemy ( ) ; 

It is important to realize that mySoldier 2 is a totally separate object with totally 
separate instance variables. 

objects of 

classes in order to make them useful. 



[ 



As always, there are exceptions to this rule, but they are in the minority, 
e 

already seen an exception way back in Chapter 3, Speaking Java - Your 
First Game. Think of Toast. 


Let's explore basic classes a little more deeply. 
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Basic classes 

What happens when we want an army of Soldier objects? We will instantiate 

n variables 

iables. 

t is in the 

chapter6 folder and is called simply BasicClasses. Or read on to create your own 
working example: 

1. Create a project with a blank activity, just as we did in Chapter 2, Getting 
Started with Android. Clean up the code by deleting the unnecessary parts, 
but this isn't essential. Call the application BasicClasses. 

2. Now we create a new class called Soldier. Right-click on the com . 
packtpub . basicc lasses folder in the Project Explorer window. Click on 
New, then on Java Class. In the Name field, type Soldier and click on 
OK. The new class is created for us, with a code template ready to put our 
ot: 


c MainActivity.java x c Soldier.java x 

package com. packtpub . basicclasses .app; 

$/** 

) Created by John on 30/07/2014 . 

public class Soldier { 

h 


3. Notice that Android Studio has put the class in the same package as the rest 
ss 

implementation code within the opening and closing curly braces of the 
Soldier class: 
public class Soldier { 
int health; 

String soldierType; 

void shootEnemy ( ) { 

//lets print which type of soldier is shooting 
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Log. i (soldierType, " is shooting"); 

} 

} 

4. Now that we have a class, a blueprint for our future objects of the Soldier 
tab of 

MainActivity.java. We will write this code, as so often, within the onCreate 
method just after the call to setContentview: 

//first we make an object of type soldier 
Soldier rambo = new SoldierO; 
rambo . soldierType = "Green Beret"; 

rambo. health = 150;// It takes a lot to kill Rambo 

//Now we make another Soldier object 

Soldier vassily = new SoldierO; 

vassily . soldierType = "Sniper"; 

vassily . health = 50;//Snipers have less armor 

//And one more Soldier object 
Soldier Wellington = new SoldierO; 

Wellington . soldierType = "Sailor"; 

Wellington . health = 100;//He's tough but no green beret 


feature in Android Studio. Notice that after you have declared and 
created a new object, all you have to do is begin typing the object's 
name and all the autocomp lete options will present themselves. 

5. Now that we have our extremely varied and somewhat unlikely army, we 
ng code 

below the code in the previous step: 

Log . i ( "Rambo ' s health = ", " " + rambo . health) ; 

Log . i ( "Vassily ' s health = ", "" + vassily . health) ; 

Log . i ( "Wellington ' s health = ", "" + Wellington . health) ; 

rambo . shootEnemy ( ) ; 
vassily . shootEnemy ( ) ; 

Wellington . shootEnemy ( ) ; 

6. Now we can run our app on an emulator. Remember, all the output will be in 
the LogCat console window. 
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This is how the preceding pieces of code work. In step 2, Android Studio created a 
template for our new Soldier class. In step 3, we implemented our class in quite the 
same way that we have before — two variables, an int and a string, called health 
and soldierType, respectively. 

We also have a method in our class called shootEnemy. Let's look at it again and 
examine what is going on: 

void shootEnemy ( ) { 

//lets print which type of soldier is shooting 
Log. i (soldierType, " is shooting"); 

} 


In the body of the method, we print the soldierType string to the console first, and 
then the arbitrary " is shooting" string. What's neat here is that the soldierType 
string will be different depending on which object we call the shootEnemy method on. 

In step 4, we declared, created, and assigned three new objects of type Soldier. 
They where rambo, vassily, and Wellington. In step 5, we initialized each with 
a different value for health as well as soldierType. 

Here is the output: 

Rambo ' s health =: 150 
Vassily's health =: 50 
Wellington's health =: 100 
Green Beret: is shooting 
Sniper: is shooting 
Sailor: is shooting 

Notice that each time we access the health variable of each Soldier object, it is 
printed to the value we assigned it, demonstrating that although the three objects 
are of the same type, they are completely separate individual objects. 

Perhaps more interesting are the three calls to shootEnemy. One call by each of 

our Soldier objects 1 shootEnemy method is made, and we print the soldierType 

ndividual 

t created from 

the same Soldier class. 
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More things we can do with our first class 

We can treat a class much like other variables. Assuming we have already 
implemented our Soldier class, we can make an array of Soldier objects like this: 

//Declare an array called myArmy to hold 10 Soldier objects 
Soldier [] myArmy = new Soldier [10] ; 


//Then we can add the Soldier objects 

//We use the familiar array notation on the 

//And the newly learnt new Soldier () syntax 

myArmy [0] = new Soldier (); 

myArmy [1] = new Soldier () ; 

myArmy[2] = new Soldier (); 

myArmy[3] = new Soldier (); 

//Initialize more here 

//. . 


left 

on the right 


tation as we 

did for regular variables, like this: 

myArmy [0] .health = 12 5; 
myArmy [0] . soldierType = "Pilot"; 
myArmy [ 0 ] . shootEnemy ( ) ; 

// Pilot: is shooting 


We can also use a class as an argument in a method call. Here is a hypothetical call to 
a healSoldier method: 


healSoldier (rambo) ; 

//Perhaps healSoldier could add to the health instance variable 



Of course, the preceding example might raise questions like should the 
healSoldier method be a method of a class? 

someHospitalObj ectPerhaps . healSoldier (rambo) ; 

upon what is the best solution for the situation. We will look at more 
OOP, and then the best solution for lots of similar conundrums should 
present themselves more easily. 
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urn value 

of a method. Here is what the hypothetical healSoldier method might look like: 

Soldier healSoldier (Soldier soldierToBeHealed) { 
soldierToBeHealed . health++ ; 

return soldierToBeHealed; 

} 


hat, so to try and 

consolidate all this class stuff with what we already know, let's take another look at 
variables and encapsulation. 


Encapsulation 

izing 

convention, although we did discuss the wider goals of all this OOP stuff. Now 
we will take things further and begin to see how we actually manage to achieve 
encapsulation with OOP. 



Definition of encapsulation 

As we have learned encapsulation means keeping the internal workings 
of your code safe from interference from the programs that use it, 
allowing only the variables and methods you choose to be accessed. 

This means your code can always be updated, extended, or improved 
without affecting the programs that use it, as long as the exposed parts 
are still made available in the same way. It also allows the code that 
uses your encapsulated code to be much simpler and easier to maintain 


you might 
ance variables 

like this rambo .health = 100;, isn't it possible that eventually things could start to 
go wrong, perhaps like the following line of code? 

rambo . soldierType = "ballerina"; 
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t meant 

to be. By strictly controlling the way that your code is used, it can only ever do 

into errors 

works 

internally, without breaking any programs that are using an older version of the 
code or the rest of your program: 

weighlifter . legstrength = 100; 
weighlifter . armstrength = -100; 
weightlif ter . liftHeavyWeight ( ) ; 

//one typo and weightlif ter rips own arms off 

We can encapsulate our classes to avoid this, and here is how. 

Controlling the use of classes with access 
modifiers 

ny 

program that uses their class. We can add an access modifier before the class 
keyword, like this: 

public class Soldier{ 

//Implementation goes here 

} 

There are two class access modifiers. Let's briefly look at each in turn: 

• public: This is straightforward. A class declared as public can be seen by all 
other classes. 

• default: A class has default access when no access modifier is specified. This 
will make it public but only to classes in the same package, and inaccessible 
to all others. 

a glance, 

the access modifiers described are not very fine-grained. We seem to be limited to 
-all. 

Actually, the benefits here are easily taken advantage of. The idea would be to 
design a package that fulfills a set of tasks. Then all the complex inner workings of 
the package, the stuff that shouldn't be messed with by anybody but our package, 
should have default access (only accessible to classes within the package). We can 
thers (or other 

distinct parts of our program). 
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For the size and complexity of the games in this book, 
multiple packages are almost certainly overkill. 

Class access in a nutshell 

containing 

only default or default and public classes. 

In addition to class-level privacy controls, Java gives us very fine-grained controls, 
but to use these controls, we have to look at variables in more detail. 

Controlling the use of variables with access 
modifiers 

To build on class visibility controls, we have variable access modifiers. Here is a 
variable with the private access modifier being declared: 

private int mylnt ; 

Note also that all of our discussion of variable access modifiers applies to object 
variables too. For example, here is an instance of our Soldier class being declared, 
created, and assigned. As you can see, the access specified in this case is public: 

public Soldier mySoldier = new Soldier (); 

Before you apply a modifier to a variable, you must first consider the class visibility. 
If class a is not visible to class b, say because class a has default access and class b is 
tiers you 

use on the variables in class a; class b still can't see it. 

Thus, it makes sense to show a class to another class when necessary, but you should 
only expose the variables that are needed — not everything. 

We have a bit more to cover on access modifiers, and then we will look at a few 
different 

variable access modifiers. They are more numerous and fine-grained than the class 
access modifiers. Most of the explanations are straightforward, and the ones that 
might raise questions will become clearer when we look at an example. 
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The depth and complexity of access modification is not so much in the range of 
modifi 

worthy goals of encapsulation. Here are the variable access modifiers: 

• public: You guessed it! Any class or method from any package can see this 
variable. Use public only when you are sure that this is what you want. 

• protected: This is the next least restrictive modifier after public, protected 
ng as 

they are in the same package. 

• default: This doesn't sound as restrictive as protected, but it is more so. A 
variable has default access when no access is specified. The fact that default 
hiding 

our variables rather than exposing them. At this point, we need to introduce 
a new concept. Do you remember that we briefly discussed inheritance, and 
how we can quickly take on the attributes of a class and yet refine it using the 
extends 

to subclasses. This means that when we extend a class like we did with 
Activity, we cannot see its default variables. We will look at inheritance in 
more detail later in the chapter. 

• private: These variables can only be seen within the class they are declared. 
Like default access, they cannot be seen by subclasses (inherited classes). 

Variable access in a nutshell 

containing 
les will have 

carefully chosen and most likely varied access modifiers. 

There's one more twist in all this access modification stuff before we get practical 
with it. 


Methods have access modifiers too 

ill want to 

control what users of our class can and can't do. The general idea here is that some 
sers of the 

class, and some methods will be fundamental to how users use your class. 

The access modifiers for methods are the same as those for the class variables. This 
lation is a 

matter of design rather than any specific set of rules. 
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ublic class, 

can be used by any other class: 

public useMeEverybody ( ) { 

//do something everyone needs to do here 

} 

hat 

created it: 

private secretlnternalTask ( ) { 

//do something that helps the class function internally 
//Perhaps, if it is part of the same class, 

//useMeEverybody could use this method... 

//On behalf of the classes outside of this class. 

/ /Neat ! 

} 

The next method has default visibility with no access specified. It can be used only 
this default 

access method, the class will not have access to this method: 

f airlySecretTask ( ) { 

//allow just the classes in the package 
//Not for external use 

} 


Here is a last example before we move on. It contains a protected method, only 
visible to the package, but usable by our classes that extend it: 

protected f amilyTask ( ) { 

//allow just the classes in the package 
//And you can use me if you extend me too 

} 

Method access in a nutshell 

Method access should be chosen to best enforce the principles we have already 
discussed. It should provide the users of your class with just the access they need, 
such as 

keeping the internal workings of your code safe from interference from the programs 
that use it, for all the reasons we have discussed. 
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Accessing private variables with the getter 
and setter methods 

we allow access 

to them without spoiling our encapsulation? What if an object of the Hospital class 
wanted access to the health member variable from an object of type Soldier so that 
it could increase it? The health variable should be private, right? 

and yet 

allow some kind of limited access to some of them, we use getters and setters. 
Getters and setters are methods that just get and set variable values. 

This is not some special or new Java thing we have to learn. It is just a convention 
for the use of what we already know. Let's take a look at getters and setters using the 
example of our Soldier and Hospital classes. 

In this example, each of our two classes are created in their own file but the same 
package. First of all, here is our hypothetical Hospital class: 

class Hospitalj 

private void healSoldier (Soldier soldierToHeal) { 
int health = soldierToHeal . getHealth () ; 
health = health + 10; 
soldierToHeal . setHealth (health) ; 



Our implementation of the Hospital class has just one method, healSoldier. It 
receives a reference to a Soldier object as a parameter, so this method will work on 
whichever Soldier object is passed in: vassily, Wellington, rambo, or whoever. 

It also has a health variable. It uses this variable to temporarily hold and increase 
the soldier's health. In the same line, it initializes the health variable to the Soldier 
object's current health. The Soldier object's health is private, so the public getter 
method is used instead. 

Then health is increased by 10 and the setHealth setter method loads the new 
health value back to the Soldier object. 

The key here is that although a Hospital object can change a Soldier object's 

he getter 

rroneous 

or harmful values. 
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Next comes our hypothetical Soldier class, with the simplest implementation 
possible of it's getter and setter methods: 

public class Soldier{ 
private int health; 
public int getHealth(){ 
return health; 

} 

public void setHealth ( int newHealth) { 
health = newHealth; 

} 

} 

We have one instance variable called health and it is private. Private means it can 
only be changed by methods of the Soldier class. We then have a public getHealth 
method, which unsurprisingly returns the value held in the private health variable 
of the int type. As this method is public, anyone with access to the Soldier class 
can use it. 

Next, the setHealth method is implemented. Again it is public, but this time, it 
takes int as a parameter and assigns whatever value is passed to the private health 
variable. In a more life-like example, we would write some more code here to ensure 
that the value passed is within the bounds we expect. 

two new 

classes and see how our getters and setters work: 

Soldier mySoldier = new Soldier (); 

//mySoldier . health = 100 ; //Doesn 1 t work private 
//we can use the public setter setHealth () 
mySoldier . setHealth ( 100 ) ;//That's better 

Hospital militaryHospital = new Hospital (); 

/ /Oh no mySoldier has been wounded 
mySoldier . setHealth ( 10 ) ; 

/ /Take him to the hospital 
/ /But my health variable is private 
//And Hospital won't be able to access it 
//I'm doomed - tell Laura I love her 

//No wait- what about my public getters and setters? 
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//We can use the public getters and setters from another class 


militaryHospital . healSoldier (mySoldier ) ; 


//mySoldiers private variable health has been increased by 10 
//I'm feeling much better thanks! 

We see that we can call our public setHealth and getHealth methods directly on 
our object of type Soldier. Not only that, we can also call the healSoldier method 
of the Hospital object, passing in a reference to the Soldier object, which can use 
the public getters and setters to manipulate the private health variable. 

We see that the private health variable is simply accessible, yet totally within the 
control of the designer of the Soldier class. 

If you want to play around with this example, there is a working app in the code 
bundle in the Chap ter 6 folder, called Getters And Setters. I have added a few 
way we did 

to keep the key parts of the code as clear as possible. We will soon build some real 
working examples that explore class, variable, and method access. 



Getters and setters are sometimes referred to by their more 
correct names. Accessors and Mutators. We will stick to 
getters and setters. Just thought you might like to know. 


] 


Yet again, our example and the explanation are probably raising more questions. 
That's good! Previously, I said that: 

• There are two access modifiers for a class, default and public 

• Objects of classes are a type of reference variable 

• Variables (including objects) have even more access possibilities 

1 as local 

and instance variables. We will do so in a moment in the Variables revisited section. In 
that section, we will consolidate our information further to get a tighter grip on this 
OOP stuff. First let's remind ourselves of a bit about encapsulation. 

Using encapsulation features (such as access control) is like signing a really 
important deal about how to use and access a class, its methods, and its variables. 
The contract is not just an agreement about the present but an implied guarantee for 
re more ways 

that we refine and strengthen this contract. 
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It is perfectly possible to rewrite every example in this book without 
thinking or caring about encapsulation. In fact, the projects in this book 
outside of this chapter are quite lax about encapsulation. 

Use encapsulation where it is needed or, of course, if you are being 


you are learning is encapsulation itself. 

We are learning this Java OOP stuff under the assumption that you will 
one day want to write much more complex apps, whether on Android 
or some other platform that uses OOP. 


Setting up our objects with constructors 

it mean that we 

need a getter and a setter for every private variable? What about a class with lots of 
variables that need initializing at the start? Think about this: 

mySoldier . name 
mysoldier . type 
mySoldier . weapon 
mySoldier . regiment 


setters, 

but what if we just want to set things up when the object is first created to make the 
r) for each? 

For this, we have a special method called a constructor. Here, we create an object of 
type Soldier and assign it to an object called mysoldier: 

Soldier mySoldier = new Soldier (); 

There's nothing new here, but look at the last part of that line of code: 

. . . Soldier ( ) ; 

This looks suspiciously like a method. 

We have called a special method called a constructor that has been supplied 
automatically for us by the compiler. 
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override it, 

which means we can do really useful things to set up our new object before it is 
used and any of its methods are placed on the stack: 

public Soldier (){ 
health = 200; 

//more setup here 

} 


This is a constructor. It has a lot of syntactical similarities to a method. It can only 
be run with the use of the new keyword. It is created for us automatically by the 
compiler unless we create our own like in the previous code. 

Constructors have the following properties: 

• They have no return type 

• They have the same name as the class 

• They can have parameters 

• They can be overloaded 

We will play with constructors in the next demo. 

Variables revisited 

You probably remember, back in the math game project, that we kept changing 
where we declared our variables. First, we declared some in onCreate, then we 
them 

member or instance variables. 

Because we didn't specify the access, they were of default access and visible to 
the whole class, and as everything took place in the one class, we could access 
from 

onClick, but why couldn't we do that when they were declared in onCreate? 
Further explanation about when and how we can access different variables is 
probably going to be useful. 

The stack and the heap 

The VM inside every Android device takes care of memory allocation to our games. 


Variables that we declare and initialize in methods are stored on the area of memory 
known as the stack. We can stick to our warehouse analogy when talking about the 
stack— almost. We already know how we can manipulate the stack. 
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Let's talk ch 

include objects (of classes) and arrays, are stored in the heap. Think of the heap as a 
separate area of the same warehouse. The heap has lots of floor space for odd-shaped 
objects, racks for smaller objects, lots of long rows with smaller sized cube-shaped 
holes for arrays, and so on. This is where our objects are stored. The problem is that 
we have no direct access to the heap. 

Let's look again at what exactly a reference variable is. It is a variable that we refer 
defined as an 

address or location. The reference (address or location) of the object is on the stack, 
a specific 

location as stored in the reference. 

ss 

actual variable. An analogy might be that primitives are right there (on 
address. In this analogy, all addresses are on the heap. 

Why would we ever want a system like this? Just give me my objects on the 
stack already! 

A quick break to throw out the trash 

Remember way back in the first chapter when I said Java was easier to learn than 
tack 

and heap thing does that for us. 

in the 
the stack. 

If it finds 
inology, it 
le driving 
No 

variable, we 

can't possibly do anything with it anyway. This system of garbage collection helps 
our games run more efficiently by freeing unused memory. 

So variables declared in a method are local, on the stack, and only visible within the 

eferenced 

cification 

allows the referencing, 
from where. 
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In the next 
e new 
ideas too. 

We will look at the following topics: 

• Static variables that are consistent (the same) across every instance of a class 

• Static methods of a class where you can use the methods of a class without an 
object of that class type 

• We will demonstrate the scope of class and local variables, and where they 
can and can't be seen by different parts of the program 

• We will look at the this keyword, which allows us to write code that refers 
to variables that belong to a specific instance of a class, but without keeping 
track of which instance we are currently using 

The following is the demo. 

Access, scope, this, static, and constructors demo 

ir scope 
of them in 
use, but more 

of a demonstration to help understand access modifiers for classes, methods, and 
(or primitive) 

and local (or instance). Then we will cover the new concepts of static and final 
variables and the this keyword. The completed project is in the Chapter6 folder of 
the code download. It is called AccessScopeThisAndStatic. We will now perform 
the following steps to implement it: 

1. Create a new blank activity project and call it AccessScopeThisAndStatic. 

2. Create a new class by right-clicking on the existing MainActivity class 
in the Project Explorer and navigating to New | Class. Name the new 
class AlienShip. 

3. Now we declare our new class and some member variables. Note that 
numShips is private and static. We will soon see how this variable is the same 
across all instances of the class. The shieldstrength variable is private and 
shipName is public: 

public class AlienShip { 
private static int numShips; 
private int shieldstrength; 
public String shipName; 
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4. Next is the constructor. We can see that the constructor is public, has no 

/ 

we increment the private static numShips variable. Remember that this 
will happen each time we create a new object of the AlienShip type. The 
constructor also sets a value for the shieldstrength private variable using 
the private setShieldStrength method: 
public AlienShip (){ 
numShips++ ; 

//Can call private methods from here because I am part 
//of the class 

//If didn't have "this" then this call might be less clear 
//But this "this" isn't strictly necessary 
this . setShieldStrength (100) ; 

//Because of "this" I am sure I am setting 
//the correct shieldstrength 

} 

5. Here is the public static getter method that classes outside AlienShip can 
use to find out how many AlienShip objects are there. We will also see the 
unusual way in which we use static methods: 

public static int getNumShips ( ) { 
return numShips ; 


6. The following code shows our private setShieldStrength method. We 
could have just set shieldstrength directly from within the class, but this 
code shows how we can distinguish between the shieldstrength local 
variable/ parameter and the shieldstrength member variable using the 
this keyword: 

private void setShieldStrength ( int shieldstrength) { 

//"this" distinguishes between the 
//member variable shieldstrength 

//And the local variable/parameter of the same name 
this . shieldstrength = shieldstrength; 


} 

7. This next method is the getter, so other classes can read but not alter the 
shield strength of each AlienShip object: 
public int getShieldStrength ( ) { 
return this . shieldstrength; 

} 
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8. Now we have a public method that can be called every time an AlienShip 

t 

particular object's shieldStrength is zero. If it is zero, it calls the 
destroyShip method, which we look at next: 
public void hitDetected ( ) { 

shieldStrength -=25; 

Log . i ( " Incomiming : " , "Bam ! ! " ) ; 
if (shieldStrength == 0) { 
destroyShip ( ) ; 

} 


9. Finally, we will look at the destroyShip method for our AlienShip class, 
n 

its shipName, as well as increment the numShips static variable so that we can 
keep track of the number of objects of the AlienShip type we have: 
private void destroyShip () { 
numShips- - ; 

Log . i ( "Explosion : ", "" +this . shipName + " destroyed"); 

} ~ 

} 

10. Now we switch over to our MainActivity class and write some code that 
uses our new AlienShip class. All of the code goes in the onCreate method 
after the call to setContentview. First, we create two new AlienShip objects 
called girl Ship and boyShip: 

/ /every time we do this the constructor runs 
AlienShip girlShip = new AlienShip () ; 

AlienShip boyShip = new AlienShipO; 

11. Look how we get the value in numShips. We use the getNumShips method as 
lass 

name and not an object. We can also access static variables with methods that 
are not static. We did it this way to see a static method in action: 

//Look no objects but using the static method 
Log . i ( "numShips : ", "" + AlienShip . getNumShips ()) ; 

12. Now we assign names to our public shipName string variables: 

/ /This works because shipName is public 

girlShip . shipName = "Corrine Yu"; 
boyShip . shipName = "Andre LaMothe"; 
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13. If we attempt to assign a value directly to a private variable, it won't work. 
Therefore, we use the public getshieldstrength getter method to print the 
value of shieldStrength, which was assigned to the constructor: 

//This won't work because shieldStrength is private 
//girlship . shieldStrength = 999; 

//But we have a public getter 

Log . i ( "girlship shieldStrngth : ", "" + girlship. 
getshieldstrength ( ) ) ; 

Log . i ( "boyShip shieldStrngth: ", "" + boyShip . 

getshieldstrength ( ) ) ; 

//And we can't do this because it's private 
/ /boyship . setShieldStrength (1000000) ; 

Finally, we get to blow some stuff up by playing with the hitDetected 
method and occasionally checking the shield strength of our two objects: 

//let's shoot some ships 
girlship . hitDetected ( ) ; 

Log . i ( "girlship shieldStrngth: ", "" + girlship. 
getshieldstrength ( ) ) ; 

Log . i ( "boyShip shieldStrngth: ", "" + boyShip. 

getshieldstrength ( ) ) ; 

boyShip . hitDetected ( ) ; 
boyShip . hitDetected ( ) ; 
boyShip . hitDetected ( ) ; 

Log . i ( "girlship shieldStrngth: ", "" + girlship. 
getshieldstrength ( ) ) ; 

Log . i ( "boyShip shieldStrngth: ", "" + boyShip. 

getshieldstrength ( ) ) ; 

boyShip . hitDetected ( ) ; // ahhh 

Log . i ( "girlship shieldStrngth: ", "" + girlship. 
getshieldstrength ( ) ) ; 

Log . i ( "boyShip shieldStrngth: ", "" + boyShip. 

getshieldstrength ( ) ) ; 
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14. When we think we have destroyed a ship, we again use our static 
getNumShips method to check whether our static variable numShips 
was changed by the destroyShip method: 

Log . i ( "numShips : ", "" + AlienShip . getNumShips ()) ; 

15. Run the demo and look at the console output. 

Here is the output of the preceding blocks of code: 

numShips : : 2 

girlShip shieldStrngth : : 100 
boyShip shieldStrngth: : 100 
Incomiming : : Bam! ! 
girlShip shieldStrngth: : 75 
boyShip shieldStrngth: : 100 
Incomiming: : Bam! ! 

Incomiming: : Bam! ! 

Incomiming: : Bam! ! 
girlShip shieldStrngth: : 75 
boyShip shieldStrngth: : 25 
Incomiming: : Bam! ! 

Explosion: : Andre LaMothe destroyed 
girlShip shieldStrngth: : 75 
boyShip shieldStrngth: : 0 
numShips : : 1 

boyShip shieldStrngth: : 0 
numShips : : 1 

d member 

variables of the same name using the this keyword. We can also use the this 
keyword to write code that refers to the current object being acted upon. 

We saw that a static variable, in this case numShips, is consistent across all 
ing 

it in our destroyShip method, we can keep track of the number of AlienShip 
objects we created. 

h the dot 

operator instead of an object. 
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Finally, we demonstrated how we could hide and expose certain methods and 
variables using an access specifier. 

Let's take a look at a quick review of the stack and the heap before we move on to 
something new. 

A quick summary on stack and heap 

Let's look at what we learned about the stack and the heap: 

• You don't delete objects but the VM sends the garbage collector when 
e 

reference to the object. 

• Local variables and methods are on the stack, and local variables are local to 
the specific method within which they were declared. 

• Instance or class variables are on the heap (with their objects) but the 
reference to the object (address) is a local variable on the stack. 

• We control what goes inside the stack. We can use the objects on the heap but 
only by referencing them. 

• The heap is maintained by the garbage collector. 

• An object is garbage collected when there is no longer a valid reference to it. 
Therefore, when a reference variable, local or instance, is removed from the 
d when 

it will 

free the RAM memory to avoid running out. 

• If we try to reference an object that doesn't exist, we will get a null pointer 
exception and the game will crash. 


Inheritance 

We have seen how we can use other people's hard work by instantiating/ creating 
objects from the classes of an API such as that of Android, but this whole OOP thing 
goes even further than that. 

What if there is a class that has loads of useful functionality in it but not quite what 
we want? We can inherit from the class and then further refine or add to how it 
works and what it does. 
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we have 

keyword, we are inheriting, for example, in this line of code: 
public class MainActivity extends Activity . . . 


extends 


Here, we are inheriting the Activity class along with all its functionality, or more 
specifi access to. 

Here are some of the things we can do to classes we have extended, 
in the 

class we inherit from. For example, we overrode the onCreate method every time 
we extended the Activity class, but we also called the default implementation 
provided by the class designers when we did this: 

super . onCreate ( . . . 


Activity 

class. Specifically, we'll override the methods that handle the lifecycle. 

If we or the designer of a class wants to force us to inherit before we use their class, 
they can declare a class as abstract. Then we cannot make an object from it. Therefore, 
we must extend it first and make an object from the subclass. We will do this in our 
inheritance example and discuss it further when we look at polymorphism. 

n in any 
s well in our 
inheritance example. 

be extending. 

We have no need of that in the context of learning about building simple games, 
game. 

und us 
and as the fi 

or others can extend. With this in mind, let's make some simple classes and see how 
we can extend them, just to play around with the syntax as a first step, and also to 
this chapter, 

polymorphism, we will also dig a little deeper into inheritance. 
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An example of inheritance 

We have looked at the way we can create hierarchies of classes to model the system 
that fiuses 

inheritance. The completed project is in the Chapter6 folder of the code download. 

It is called inheritanceExample. We will now perform the following steps: 

1. Create three new classes in the usual way. Call one AlienShip, another 
Fighter, and the last one Bomber. 

2. Here is the code for the AlienShip class. It is very similar to our previous 
AlienShip class demo. The differences are that the constructor now takes an 
intSO 

d. 

The AlienShip class also has a new method, f ireWeapon, that is declared 
abstract. This guarantees that any class that subclasses AlienShip must 
implement their own version of f ireWeapon. Notice that the class has the 
abstract keyword as part of its declaration. We have to do this because 
one of its methods also uses the keyword abstract. We will explain the 
abstract method when discussing this demo and the abstract class when 
we talk about polymorphism: 

public abstract class AlienShip { 
private static int numShips; 
private int shieldStrength; 
public String shipName; 

public AlienShip ( int shieldStrength) { 

Log . i ( "Location : ", "AlienShip constructor") ; 
numShips++ ; 

setShieldStrength ( shieldStrength) ; 

} 


public abstract void f ireWeapon (); //Ahh my body 

public static int getNumShips ( ) { 
return numShips ; 

} 


private void setShieldStrength ( int shieldStrength) { 
this . shieldStrength = shieldStrength; 

} 


public int getShieldStrength ( ) { 
return this . shieldStrength; 
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} 

public void hitDetected ( ) { 
shieldStrength -=25; 

Log . i ( " Incomiming : ", "Bam!!"); 

if (shieldStrength == 0) { 
destroyShip ( ) ; 

} 


private void destroyShip () { 
numShips- - ; 

Log . i ( "Explosion : ", "" + this . shipName + " destroyed"); 

} 


3. Now we will implement the Bomber class. Notice the call to super (100) . This 
calls the constructor of the superclass with the value for shieldStrength. 

We could do further specific Bomber initialization in this constructor, but 
for now, we just print the location so that we can see when the Bomber 
constructor is being executed. We also implement a Bomber class-specific 
version of the abstract f ireWeapon method because we must do so: 
public class Bomber extends AlienShip { 

public Bomber (){ 
super (100) ; 

//Weak shields for a bomber 

Log . i ( "Location : ", "Bomber constructor") ; 

} 


public void f ireWeapon () { 

Log . i (" Firing weapon: ", "bombs away"); 

} 
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4. Now we will implement the Fighter class. Notice the call to 

super (4 00) . This calls the constructor of the superclass with the value of 
shieldStrength. We could do further Fighter class-specific initialization 
can 

see when the Fighter constructor is being executed. We also implement a 
Fighter specific version of the abstract f ireWeapon method because we 
must do so: 

public class Fighter extends AlienShip{ 

public Fighter () { 
super (400) ; 

//Strong shields for a fighter 

Log . i ( "Location : ", "Fighter constructor") ; 

} 


public void f ireWeapon () { 

Log . i (" Firing weapon: ", "lasers firing"); 

} 


5. Here is our code in the onCreate method of MainActivity. As usual, we 
enter this code after the call to setContentview. This is the code that uses 
it is 

the output that is interesting: 

Fighter aFighter = new Fighter ( ) ; 

Bomber aBomber = new Bomber ( ) ; 

//Can't do this AlienShip is abstract - 
//Literally speaking as well as in code 
//AlienShip alienShip = new AlienShip (500) ; 

//But our objects of the subclasses can still do 
//everything the AlienShip is meant to do 
aBomber . shipName = "Newell Bomber"; 
aFighter . shipName = "Meier Fighter"; 

//And because of the overridden constructor 
//That still calls the super constructor 
//They have unique properties 

Log . i ( "aFighter Shield:", ""+ aFighter . getShieldStrength ( ) ) ; 
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Log . i ( "aBomber Shield:", ""+ aBomber . getShieldStrength ()) ; 

//As well as certain things in certain ways 
//That are unique to the subclass 
aBomber . fireWeapon ( ) ; 
aFighter . fireWeapon ( ) ; 

//Take down those alien ships 

//Focus on the bomber it has a weaker shield 

aBomber . hitDetected ( ) ; 

aBomber . hitDetected ( ) ; 

aBomber . hitDetected ( ) ; 

aBomber . hitDetected ( ) ; 

Here is the output of the preceding snippets of code: 

Location: : AlienShip constructor 
Location: : Fighter constructor 
Location: : AlienShip constructor 
Location: : Bomber constructor 
aFighter Shield: : 400 
aBomber Shield: : 100 
Firing weapon: : bombs away 
Firing weapon: : lasers firing 
Incomiming: : Bam! ! 

Incomiming: : Bam! ! 

Incomiming: : Bam! ! 

Incomiming: : Bam! ! 

Explosion: : Newell Bomber destroyed 

We can see how the constructor of the subclass can call the constructor of the 
superclass. We can also clearly see that the individual implementations of the 
fireWeapon method work exactly as expected. 

bjects 
n make 

OOP even more useful by subclassing/extending/inheriting from other classes. The 
terminology we might like to learn here is that the class that is extended from is the 
superclass and the class that inherits from the superclass is the subclass. We can also 
call them parent and child classes. 
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As usual, we might find ourselves asking this question about 
inheritance: Why? We can write common code once, in the parent 
class, and we can update that common code. All the classes that 

public instance variables and methods. When designed properly, this 
further enhances the goals of encapsulation. 


Polymorphism 

Polymorphism roughly means different forms. But what does it mean to us? 

In the simplest words possible, any subclass can be used as a part of the code that 
uses the superclass. 

t is of a type 

that is a subclass of Animal in the Animal array, perhaps cats and dogs. 

This means that we can write code that is simpler and easier to understand 
and modify: 

//This code assumes we have an Animal class 

//And we have a Cat and Dog class that extends Animal 

Animal myAnimal = new Animal ( ) ; 

Dog myDog = new Dog ( ) ; 

Cat myCat = new Cat ( ) ; 

Animal [] myAnimal s = new Animal [10] ; 
myAnimals [0] = myAnimal ; //As expected 
myAnimals [1] = myDog; //This is OK too 
myAnimals [2] = myCat;//And this is fine as well 

We can also write code for the superclass and rely on the fact that no matter how 
ill work. 

Let's continue our previous example: 

//6 months later we need elephants 
//with its own unique aspects 

//As long as it extends Animal we can still do this 
Elephant myElephant = new Elephant (); 

myAnimals [3] = myElephant ; //And this is fine as well 

You can also write methods with polymorphic return types and arguments: 

Animal feedAnimal (Animal animalToFeed) { 

//Feed any animal here 
return animalToFeed; 

} 
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So you can even write code today and make another subclass in a week, month, or 
year, and the very same methods and data structures will still work. 

can and 

cannot do, and also how they should do it. Thus, good design in one stage can 
influence our subclasses at other stages. 

If you do suddenly find yourself with a flappy-bird-sized phenomenon, and you 
have a lot of OOP in your code, right from the start, it will be much easier to bring 
the project. 

What if you have an idea for a game with lots of features but you want to get a 
simple version of the game out as soon as possible? Smart, object-oriented design 
would certainly be the solution. It could enable you to write the working bare bones 
of a game and then gradually extend it. 

Moving on, let's look at another OOP concept: abstract classes. We can now get to the 
bottom of what was going on with that AlienShip code: 

public abstract class AlienShipj . . . 


Abstract classes 

An abstract class is a class that cannot be instantiated, or cannot be made into an 
object. We mentioned that AlienShip was abstract in the previous example. So is it 
a blueprint that will never be used then? But that's like paying an architect to design 
act method 
but this is just silly! 

It might seem like this at first. We make a class abstract by declaring it with the 
abstract keyword, like this: 

abstract class someClassj 

//All methods and variables here as usual 
//Just don't try and make an object out of me! 

} 


But why? 

Sometimes, we want a class that can be used as a polymorphic type but we need 
to ensure that it can never be used as an object. For example. Animal doesn't really 
make sense on its own. 

We don't talk about animals; we talk about types of animals. We don't say, "Ooh, 
look at that lovely, fluffy, white animal", or "Yesterday, we went to the pet shop and 
got an animal and an animal bed." It's just too abstract. 
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ends it 

(inherits from it). 

We might want a Worker class and extend to make classes such as Miner, 
Steelworker, Of f iceWorker, and of course Programmer. But what exactly 
does a plain Worker class do? Why would we ever want to instantiate one? 

The answer is that we wouldn't want to instantiate it, but we might want to use 
between 

methods and have data structures that can hold all types of workers. 

We call this type of class an abstract class, and when a class has even one abstract 
method, like AlienShip did, it must be declared abstract itself. As we saw, all 
ct class. 

This means that the abstract class can provide some of the common functionality that 
would be available in all its subclasses. For example, the Worker class might have the 
height, weight, and age member variables. 

It might have the getPayCheck method, which is the same in all the subclasses, 
and the doWork method, which is abstract and must be overridden because all 
the different types of worker do work very differently. 

honorable 

mention because we have been using it in every game so far. 

Interfaces 

An interface is 

class that is always abstract and with only abstract methods. 

methods abstract 

because it 

ract and serve 

as a polymorphic type. 

But seriously, this interface seems a bit pointless. Bear with me. 

To define an interface, we type the following code: 

public interface mylnterface{ 

void someAbstractMethod ( ) ; //omg I've got no body 
int anotherAbstractMethod ( ) ; //Ahh ! Me too 


//Interface methods are always abstract and public implicitly 
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//but we could make it explicit if we prefer 

public abstract explicitlyAbstractAndPublicMethod (); //still no body 
though 


they can still 

have return types and parameters, or not. 

To use an interface, we use the implements keyword after the class declaration. 

Yes, we already did this for onClickListener a few times: 

public class someClass implements somelnterf ace { 

//class stuff here 

//better implement the methods of the interface or the red error lines 
will not go away 

public void someAbstractMethod ( ) { 

//code here if you like but just an empty implementation will do 

} 


public int anotherAbstractMethod ( ) { 

//code here if you like but just an empty implementation will do 

//Must have a return type though as that is part of the contract 
return 1 ; } 


are from 
n interface, 

the whole thing can be passed along as if it is that thing, which it is. We can even 
ust add a 

comma between each interface and list them after the implements keyword. Just be 
sure to implement all the necessary methods. 

Let's go back to the onClickListener interface. Any thing might like to know 
ant 

different onClick methods for every type. 
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When using Android, for games or for more regular GUI-based apps 


3 


interfaces rather than writing your own. However, knowing what is 
happening is quite important, not so much from a point of view of 
technical awareness, as we have just seen that the interface specifies a 


knowing what is actually happening when you use the implements 
keyword and write a method (or methods) with a name that you 
didn't choose. 


More about OOP and classes 

dy done 

so, but the best way to learn OOP is probably to practice it; practice it before we 
have learned all of the theory. Anyway, before we get on with some more practical 
ave us 

scratching our heads later if not mentioned. 

Inner classes 

When we looked at our basic classes demo app, we declared and implemented the 
class in a separate file to our MainActivity class. That file had the same name as 
the class. 

We can also declare and implement a class within a class. The only question 
remaining, of course, is why would we do this? When we implement an inner 
class, the inner class can access the member variables of the enclosing class and 
the enclosing class can access the members of the inner class. We will see this in 
action in the next two chapters. 

If you are not modeling deep or real-world systems, then inner classes are often the 
of this book will 
our own 

class within our Activity class. This makes our code nice and simple. 
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Self-test questions 

Ql) Find out what is wrong with this class declaration: 

private class someClass{ 

//class implementation goes here 

} 


Q2) What is encapsulation? 
had at the start 

of the chapter. What should I do? 

Summary 

u 

just 

understand that OOP is about writing reusable, extendable, and efficient code 
potential 
rd work 
at the 

make a retro 

game in the next chapter. 
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Retro Squash Game 


viously a 

step or two down from the latest big-budget game, it is the point when we start to 
wn bump 


n and 

work and you have the potential to draw anything. Then, when we combine this 
ion and 

gravity, we will be close to being able to implement our squash game. 


Sadly, this book does not have the time to go into the mathematics 
of turning a dot on the screen into realistic three-dimensional 
characters moving around in a three-dimensional world. Certainly, the 
technology and math behind big-budget titles is very advanced and 



into triangles, texturing a triangle, building objects out of triangles, 
and positioning them in a three-dimensional world are within the 
grasp of anybody who has learned high-school-level math. Often, we 
hear that great graphics don't make a great game, which is true, but 


of video games, even when they are displayed on a game that could 
be more fun to play by itself. If you want to see how to turn pixels 
into magical worlds, and start to appreciate what goes on behind the 
scenes of the top game engines and graphics libraries, you could start 
with Computer Graphics: Mathematical First Steps, P.A. Egerton and W.S 
Hall, Prentice Hall. 


Retro Squash Game 


In this chapter, we will cover the following topics: 

• Explore the Android Canvas class, which makes drawing easy and fun 

• Write a simple Canvas demo app 

• Learn about detecting touches on the screen 

• Create the retro squash game 

• Implement the retro squash game 

Drawing with Android Canvas 

graphics. 

This is fine when all we need are objects such as buttons and text, 
plored so far. 

For example, we know we can do a lot more with the Animation class, and we very 
brieflements. 

As an example, we could assign game characters such as spaceships to UI elements 
and animate them. 

However, if we want smoothly moving spaceships with accurate collision detection, 
ation, then 

we are going to need to move away from predefined UI elements. 

We are going to need to start looking at and designing with individual pixels, lines, 
oid has 

some classes to make this nice and easy for us. We will be learning how to get started 
with the Canvas and Paint classes. 

hapter, we will 

learn how to draw pixels and lines to make a simple, smoothly moving pong-style 
game of squash. 

w our pixels 

and lines. Then we will look at the Paint and Canvas classes themselves. 
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The Android coordinate system 

A pixel is the smallest graphical element we can manipulate using the Paint and 
Canvas classes. It is essentially a dot. If your device resolution is 1920 x 1080, like 
n 

els 

across the width, 
id. We 

draw using the Canvas and Paint classes on a virtual canvas. We will do so by 
this grid. 

The coordinate system starts in the top-left corner of the screen. 

As an example, take a look at this line of code: 

drawPoint(0, 0) ; //Not actual syntax (but very close) 

en. Now look at 
the following code: 

drawPoint (1920 , 1080); //Not actual syntax (but very close) 
of one of these 

high-end devices (while in the landscape position). 


on, 

a bit like this: 

drawLine (0 , 0 , 1920 , 1080); //Not actual syntax (but very close) 

tom right, 
devices 

have such a high resolution; in fact, most are significantly lower. Even devices with 
dscape or 
regardless of 

the screen resolution? We will see the solution soon. 
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Animating our pixels 

hem appear 

to move? We will be using the same animation trick used in cartoons, movies, and 
other video games: 

1. Draw an object. 

2. Rub it out. 

3. Draw the object in its new position. 

4. Repeat fast enough to trick the player's brain that the game objects are moving. 

The theory makes all of this sound more complicated than it is. Let's take a quick 
look at the Paint and Canvas classes and a quick introductory demo app. Then we 
can implement our retro squash game for real. 

Getting started with Canvas and Paint 

The aptly named Canvas class provides just what you would expect— a virtual 
canvas to draw our graphics on. 

We can make a virtual canvas using the Canvas class from any Android UI element. 

, we 

a advantages, 
as we will see. 

view from 

our UI layout using Java code: 

ImageView ourView = (ImageView) findViewByld (R . id . imageView) ; 
ign and 

assigns it to our object in our Java code. As we have seen, the ImageView in the UI 
design has an assigned ID of imageView, and our controllable ImageView object in 
our Java code is called ourView. 

creen. We 

are creating a bitmap to turn it into a canvas: 

Bitmap ourBitmap = Bitmap . createBitmap (300 , 600 , Bitmap . Config . 

ARGB_8 8 8 8) ; 
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The previous line of code declares and creates an object of the Bitmap type. It will have 
a size of 300 by 600 pixels. We will keep this in mind when we draw on it shortly. 

The last argument in the createBitmap method. Bitmap . Conf ig . 

ARGB_8 8 8 8, is simply a format, and we can create some great games 
without getting into the different options for bitmap formats. 

Now we can prepare our bitmap for drawing by creating a Canvas object from it: 

Canvas ourCanvas = new Canvas (ourBitmap) ; 

Next, we get ourselves an object of the Paint type. We can think of this object as the 
brush and the paint for our virtual canvas: 

Paint paint = new Paint (); 

At this point, we are ready to use our Paint and Canvas objects to do some drawing. 
1 look like this: 

ourCanvas . drawPoint ( 0 , 0, paint) ; //How simple is that? 

Let's now look at a working example. 



Android Canvas demo app 

Let's make an app that uses the Canvas and Paint classes and do a bit of drawing, 
ly see how to 

use Canvas and Paint without cluttering the code with things we will learn later. 

In this demo app, we use some conceptually helpful variable names to help us grasp 
the role that each object is playing, but we will go through the whole thing at the end 
you don't 

have to type all of this. You can open the completed code files from the CanvasDemo 
folder in the Chapter7 folder of the download bundle: 

1. Start a new project and call it CanvasDemo. Tidy up the unnecessary imports 
and overrides if you want to. 

2. Open activity_main . xml in the editor. Drag an ImageView from the 
palette to the layout. The ImageView has an ID by default, which is 
imageView. Now we will use this ID in our code. 
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3. Switch to MainActivity . j ava in the editor. First, we will create our Bitmap, 
Canvas, and Paint objects as we discussed earlier. Here is the first part of the 
code. Enter it directly after the call to the setContentview method: 

//Get a reference to our ImageView in the layout 

ImageView ourFrame = (ImageView) findViewByld (R . id . imageView) ; 

//Create a bitmap object to use as our canvas 

Bitmap ourBitmap = Bitmap . createBitmap (300 , 600 , Bitmap . Config . 
ARGB_8 8 8 8) ; 

Canvas ourCanvas = new Canvas (ourBitmap) ; 

//A paint object that does our drawing, on our canvas 
Paint paint = new Paint ( ) ; 

4. Here, we try out some of the cool things we can draw. Enter the code directly 
after the code in the previous step: 

//Set the background color 
ourCanvas . drawColor (Color . BLACK) ; 

//Change the color of the virtual paint brush 
paint . setColor (Color . argb (255 , 255, 255, 255)); 

//Now draw a load of stuff on our canvas 

ourCanvas . drawText ( "Score : 42 Lives: 3 Hi: 97", 10, 10, paint); 
ourCanvas . drawLine (10 , 50, 200, 50, paint); 
ourCanvas . drawCircle (110 , 160, 100, paint); 
ourCanvas . drawPoint ( 10 , 260, paint); 

//Now put the canvas in the frame 
ourFrame . setlmageBitmap (ourBitmap) ; 

5. Run the demo on an emulator or a device. 
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Your output will look like what is shown in the following screenshot: 



ect and 

placed an ImageView object with an ID of imageView on our UI layout. 
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In step 3, we started by getting a reference to the Imageview object in our layout. 

named our ImageView ourFrame because it will hold our canvas: 

Imageview ourFrame = (Imageview) findViewByld (R . id . imageview) ; 

Then we created a bitmap to be used to make a canvas: 

Bitmap ourBitmap = Bitmap . createBitmap (3 00 , 600 , Bitmap . Config . 

ARGB_8 8 8 8); 

Canvas ourCanvas = new Canvas (ourBitmap) ; 

After that, we created our new Paint object: 

Paint paint = new Paint ( ) ; 

First, we 

painted the entire canvas black: 

ourCanvas . drawColor (Color . BLACK) ; 

Then we chose the color with which we will be painting. (255, 255, 255, 255) is 

paint . setColor (Color . argb (255 , 255, 255, 255)); 
o draw 

strings of text to the screen and position that text at precise screen coordinates, just 
like we can with a pixel. 

You will notice that with the drawText method and all other drawing methods of 
the Canvas class, we always pass our Paint object as an argument. Just to make 
what is going on in the next line of code absolutely clear, I am stating that "Score : 
42 Lives: 3 Hi: 9 1 " is the string that will be drawn on the screen, io, io are the 
screen coordinates, and paint is our Paint object: 

ourCanvas . drawText ( "Score : 42 Lives: 3 Hi: 97", 10, 10, paint); 

: (start x 

coordinate, start y coordinate, end x coordinate, end y coordinate, our Paint object): 

ourCanvas . drawLine (10 , 50, 200, 50, paint); 

Now we see that we can draw circles. We can also draw other shapes. The argument 
list here can be described as follows: (start x coordinate, start y coordinate, radius of 
circle, our Paint object): 

ourCanvas . drawCircle ( 110 , 160, 100, paint); 
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ourCanvas . drawPoint ( 10 , 260, paint); 

Finally, we place our bitmap canvas on our ImageView frame: 

ourFrame . setlmageBitmap (ourBitmap) ; 
tion, and 

we will do so in our retro squash game. Also, we need to look for a system that will 

e illusion of 

might 

how the player will 

control the game. After all, we are not going to have any handy UI buttons to press 
for this game. 

Detecting touches on the screen 

he 

OnClickListener interface and override the onClick method. This is not a problem, 
11 use 

OnTouchListener and override the onTouchEvent method. It works a bit differently, 
e. 

We must implement the OnTouchListener interface for the activity we want to listen 
to touches in, like this: 

public class MainActivity extends Activity implements View. 
OnTouchListenerj 

Then we can override the onTouchEvent method, perhaps a bit like this. 

©Override 

public boolean onTouchEvent (Mot ionEvent motionEvent) { 
float x = motionEvent . getX () ; 
float y = motionEvent . getY () ; 

//do something with the x and y values 
return false; 

} 
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The xhat 

was touched, and y will hold the vertical position. It is worth noting that the 
motionEvent object parameter contains lots of information as well as the x and y 
location, for example, whether the screen was touched or released. We can make 
ee later. 

requires 

us to first consider the design of the game. 

Preparing to make the retro squash game 

w 

everything we need to. We just need to think about how to use the different 
techniques we have learned. 

Let's fi 
aim for. 

The design of the game 

Let's look at a screenshot of the game as a good starting point. When you design your 
own games, drawing sketches of the in-game objects and mechanics of the game will 
be an invaluable part of the design process. Here, we can cheat a bit by taking a look 
at the end result. 
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The Ul 

Starting from the top, we have Score. Every time the player successfully hits the ball, 
a point is added. Next, we have Lives. The player starts with three lives, and every 
time they let a ball go past their racket, they lose one life. When the player has zero 
game begins again. 

Next to this, we have FPS. FPS stands for frames per second. It would be nice if we 
ery second, 

as this is the first time we are animating our very own graphics, 
s a square ball, 

in keeping with the traditional pong style. Squares are also easier when you have to 
perform realistic-looking collision detection. 

Physics 

well as when it 

hits the racket. Depending on what the ball hits and its current direction at the time 
rough outline 

of what each type of collision will do: 

• Hit the top of the screen: The ball will maintain the same horizontal (x) 
direction of travel but reverse the vertical (y ) direction of travel. 

• Hit either side of the screen: The ball will maintain its y direction of travel 
but reverse its x direction. 

• Hit the bottom of the screen: The ball will disappear and restart at the top 
of the screen with a downward y direction of travel and a random x direction 
of travel. 

• Hit the player's racket: We will check whether the ball has hit the left or the 
right of the racket and alter the x direction of travel to match. We will also 
reverse the y direction of travel to send the ball back to the top again. 

a ball that 
roperties 

such as slightly increasing the ball speed after hitting the racket. These rules will 
work just as well in portrait or landscape orientations. 

The player's racket will be a simple rectangle that the player can slide left by holding 
anywhere on the left half of the screen, and right by holding anywhere on the right 
of the screen. 
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For brevity, we will not be making a main menu screen to implement high scores. 

In our final game, which we start in the next chapter, we will go ahead and have an 
animated menu screen, online high scores, and achievements. However, this squash 
game will simply restart when the player reaches zero lives. 


The structure of the code 

mentation 

that might be raising questions. When we finally get down to the implementation, 
we should find most of the code quite straightforward, with only a few bits that 
might need extra explanation. 

We have discussed everything we need to know, and we will also discuss specifics in 
er parts of 

the code at the end of each phase of implementation. 

As usual, all the completed code files can be found in the download bundle. The files 
encompassing all the phases of this project are in the Chapter7/RetroSquash folder. 

different 
an jumping 

back and forth in the code, we will lay it out from the first line to the last in order, 
g. I definitely 
on and 

which parts of the code call which other parts. 

t, it has 
top and 
take a break. 

There is no layout file and only one . j ava file. This file is called MainActivity . 
j ava. The MainActivity . j ava file has a structure as indicated in the following 
overview of the code. I have indented some parts to show what parts are enclosed 
tail: 


Package name and various import statements 
MainActivity class starts { 

Declare some member variables 
OnCreate methodj 

Initialization and setup 

} 

SquashCourtView class { 

Constructor 
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Multiple methods of SquashCourtView 

} 

Some Android lifecycle method overrides 


As previously stated, we can see that everything is in the MainActivity . j ava file. 

As usual, at the top of our file, we will have a package name and a load of imports 
for the different classes we will be using. 

Next, as per all our other projects, we have the MainActivity class. It encompasses 
everything else, even the SquashCourtView class. This makes the SquashCourtView 
class an inner class and will therefore be able to access the member variables of the 
MainActivity class, which will be essential in this implementation. 

Before the SquashCourtView class, however, comes the declaration of all the member 
variables in the MainActivity class, followed by a fairly in-depth onCreate method. 

We could implement the other Android lifecycle methods next, and you are welcome 
to do so. However, the code within the other Android lifecycle methods will make 
more sense once we have seen the code in the SquashCourtView class methods. 

After onCreate, we will implement the SquashCourtView class. This has some fairly 
long methods in it, so we will break it into phases 2 and 3. 

are short 
but important. 

The four implementation phases in detail 

Let's take an even closer look at the implementation before we actually get to it. Here 
with a bit 

more detail as to what to expect in each: 

• Phase 1 - MainActivity and onCreate: In this phase, we will create the 
project itself as well as implement the following steps: 

0 We will add our imports and create the body of our MainActivity 
class 

0 Within this, we will declare the member variables that the game needs 

0 We will implement our onCreate method, which does loads of setup 
work but nothing that is hard to understand 
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• Phase 2 - SquashCourtView part 1: In this phase, we will start work on our 
key class, SquashCourtView. Specifically, we will: 

° Implement the declaration of the SquashCourtView class and its 
member variables. 

0 Write a simple constructor. 

0 Implement the run method to control the flow of the game. 

0 Implement the lengthy but fairly easy-to-understand update Court 
method. This is the method that handles collision detection and keeps 
track of our ball and racket. 

• Phase 3 - SquashCourtView part 2: In this phase, we will finish the 
SquashCourtView class by implementing the following: 

0 The drawCourt method, which unsurprisingly does all the drawing 

0 The controlFPS method, which makes the game run at similar 
speeds on devices that have different CPUs 

0 Next, we will quickly write a couple of methods that help the 
Android lifecycle methods with similar names — the pause and 
resume methods 

0 Finally for this phase, we will easily handle the touch controls of the 
game by overriding the onTouchEvent method we looked at earlier 

• Phase 4 - Remaining lifecycle methods: In this short phase we will add the 
finishing touches: 

0 Quickly implement what happens in the onPause, onResume, and 
onstop methods by overriding them 

0 We will also handle what happens when the player presses the back 
button on their phone or tablet 

Phase 1 - MainActivity and onCreate 

Now that we have seen what we will do in each of the phases, let's actually get 
started with building our game by performing the following steps: 

1. Create a new project, just as we have before, but with one slight difference. 
This time, on the New Project dialog, change Minimum required SDK to 
API 13: Android 3.2 (Honeycomb). Call the project RetroSquash. Delete the 
unnecessary overridden methods if you like. 
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2. Edit the AndroidManif est . xml file, just as we did at the end of Chapter 4, 
Discovering Loops and Methods, to make the app use the full screen. Check 
back for full details if needed. Note that we are not locking orientation 
because this game is fun in both portrait and landscape. Here is the 

line of code to add: 

android : theme= "@android : style /Theme . NoTitleBar . Fullscreen" > 

3. Make some sound effects using Bfxr, as we did in Chapter 5, Gaming and 
]ava Essentials. Four will be enough, but there is nothing stopping you from 
adding more sounds. For authentic 1970s-style sounds, try the Blip/Select 
button shown in the following screenshot. Name the samples samplel . 
ogg, sample2 . ogg, sample3 . ogg, and sample4 . ogg. Or you can just use my 
samples. They are in the assets folder of the folder named RetroSquash in 
the code bundle. 


Blip/Select 


4. In Project Explorer, create a directory called assets within the main 
directory. Copy the four sound files you created in the previous step 
to the newly created assets folder. 

5. Type the following import statements at the top of the MainActivity . j ava 
file but just after your package name, as shown in the following code: 
package com . packtpub . retrosquash . app ; 

import android . app . Activity; 
import android . content . Context ; 

import android . content . res . As set FileDe scrip tor ; 

import android . content . res . AssetManager ; 

import android . graphics . Canvas ; 

import android . graphics . Color ; 

import android . graphics . Paint ; 

import android . graphics . Point ; 

import android . media . AudioManager ; 

import android . media . SoundPool ; 

import android . os . Bundle ; 

import android . view . Display ; 

import android .view . KeyEvent ; 

import android . view . MotionEvent ; 

import android .view . Surf aceHolder ; 

import android . view . Surf aceView; 

import j ava . io . IOException; 

import j ava . util . Random; 
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6. Now type your class declaration and declare the following member variables. 

public class MainActivity extends Activity { 

Canvas canvas ; 

SquashCourtView squashCourtView; 

/ / Sound 

//initialize sound variables 
private SoundPool soundPool ; 
int samplel = -1; 
int sample2 = -1; 
int sample3 = -1; 
int sample4 = -1; 

//For getting display details like the number of pixels 
Display display; 

Point size; 

int screenWidth; 

int screenHeight ; 

//Game objects 
int racketWidth; 
int racketHeight ; 

Point racketPosition; 

Point ballPosition; 
int ballWidth; 

//for ball movement 
boolean balllsMovingLef t ; 
boolean balllsMovingRight ; 
boolean balllsMovingUp; 
boolean balllsMovingDown; 

//for racket movement 
boolean racketlsMovingLef t ; 
boolean racket I sMovingRight ; 

/ / stats 

long lastFrameTime ; 
int fps; 
int score; 
int lives; 
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7. Next, we will enter the onCreate method in its entirety. We are initializing 
many of the member variables that we declared in the previous step, as 
well as creating an object from our SquashCourtview class, which we will 
begin to implement in the next phase. Perhaps the most notable line in this 
block of code is the somewhat different call to setContentview. Look at the 
argument for setContentview. We will learn more about this argument at 
the end of this phase. This phase also sets up SoundPool and loads the sound 
samples. Type the first part of the onCreate code: 
protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate ( savedlnstanceState) ; 

SquashCourtview = new SquashCourtview (this) ; 
setContentview ( SquashCourtview) ; 

//Sound code 

soundPool = new SoundPool ( 10 , 

AudioManager . STREAM_MUSIC, 0); 
try { 

//Create objects of the 2 required classes 
AssetManager assetManager = getAssetsO; 
AssetFileDescriptor descriptor; 

//create our three fx in memory ready for use 
descriptor = 

assetManager . openFd ( " samplel . ogg" ) ; 
samplel = soundPool . load (descriptor , 0) ; 

descriptor = 

assetManager . openFd ( " sample2 . ogg" ) ; 
sample2 = soundPool . load (descriptor , 0) ; 

descriptor = 

assetManager . openFd ( " sample3 . ogg" ) ; 
sample3 = soundPool . load (descriptor , 0) ; 

descriptor = 

assetManager . openFd ( " sample4 . ogg" ) ; 
sample4 = soundPool . load (descriptor , 0) ; 


} catch (IOException e) { 
//catch exceptions here 

} 
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8. Now we initialize the variables we created earlier. Notice that there are some 
he 

code readable, we will not do so at this stage. Enter this code: 

//Could this be an object with getters and setters 
//Don't want just anyone changing screen size. 

//Get the screen size in pixels 

display = getWindowManager ( ) . getDef aultDisplay ( ) ; 

size = new Point ( ) ; 

display. getSize (size) ; 

screenWidth = size.x; 

screenHeight = size.y; 


//The game objects 
racketPosition = new Point (); 
racketPosition . x = screenWidth / 2; 
racketPosition . y = screenHeight - 20; 
racketWidth = screenWidth / 8 ; 
racketHeight = 10; 

ballWidth = screenWidth / 35; 
ballPosition = new Point (); 
ballPosition . x = screenWidth / 2; 
ballPosition . y = 1 + ballWidth; 

lives = 3; 


Phase 1 code explained 

Let's look at what we did. From steps 1 to 4, we simply created a project and some 
sound files. Then we added the sound files to the assets folder as we have done 
before on other projects. In step 5, we added all the necessary imports for the classes 
we will be using. 

In step 6, we created a whole load of member variables. Let's take a closer look at 
them. We declared an object of the Canvas type called canvas. We will use this object 
to set up our drawing system. We also declared an instance of SquashCourtview 
called squashCourtview. This will be underlined as an error because we haven't 
implemented the class yet. 
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d files, just as 

we did in other projects. After this, we did something new: 

//For getting display details like the number of pixels 
Display display; 

Point size; 

int screenWidth; 

int screenHeight; 

We declared a Display object and a Point object. We see these in action in our 
onCreate method in a minute, alongside the two int variables, screenWidth and 
screenHeight. We use them to get the screen size in pixels so that we can make our 
game work on a screen with any resolution. 

Here, we declared some variables whose purpose is plain from their names, 
use 

them throughout our SquashCourtview class: 

//Game objects 
int racketWidth; 
int racketHeight ; 

Point racketPosition; 

Point ballPosition; 
int ballwidth; 

ovement 

of both the racket and the ball. Notice that there is a variable for each possible 
can move in two 
1 can travel in two 

directions at the same time. All will become clear when we write the updateCourt 
method in phase 2. Here is that code again: 

//for ball movement 
boolean balllsMovingLef t ; 
boolean balllsMovingRight ; 
boolean balllsMovingUp; 
boolean balllsMovingDown; 

//for racket movement 
boolean racketlsMovingLef t ; 
boolean racket I sMovingRight ; 
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In the last part of step 6, we declared two fairly obvious variables, lives and score. But 
what about lastFrameTime and fps? These will be used in the controlFPS method, 
which we will write in phase 3. They will be used along with some local variables to 
measure how fast our game loop runs. We can then lock it to run at a consistent rate so 
that players on devices with different CPU speeds get a similar experience. 

In step 7, we entered the onCreate method, but this time, things are different. We 
initialize squashCourtView as a new SquashCourtView object. It's fine so far, but 
then we seem to be telling setContentview to make this the entire view that the 
designer, 

which we have become used to. We are not using any Android UI components in 
this game, so the visual designer and all of its generated XML are of no use to us. As 
you will see right at the start of phase 2, our SquashCourtView class extends (inherits 
from) SurfaceView. 

We created an object with all the facilities of a SurfaceView. We will just customize 
and logical to 

set our squashCourtView object as the entire view that the player will see: 

squashCourtView = new SquashCourtView (this) ; 

setContentview ( squashCourtView) ; 

We then set up our sound effects as we have done before. 

6. Let's look at 
ticed that 
Remember that 
ault values. 

the device. 

The display object holds the details of the display after the first line has been 
executed. Then we create a new object called size of the Point type. We send size 
as an argument to the display .getsize method. The Point type has an x and 
y member variable, and so does the size object, which now holds the width and 
height (in pixels) of the display. These values are then assigned to screenwidth 
and screenHeight respectively. We will use screenwidth and screenHeight quite 
extensively in the SquashCourtView class: 

display = getWindowManager ( ) . getDef aultDisplay ( ) ; 

size = new Point (); 

display. getsize (size) ; 

screenwidth = size.x; 

screenHeight = size.y; 
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Next, we initialize the variables that determine the size and position of the ball and 
racket. Here, we initialize our racketPosition object, which is of the Point type. 
Remember that it has an x and a y member variable: 

racketPosition = new Point (); 

We initialize racketPosition.x to be whatever the current screen width in pixels 
might be, but divided by two, so the racket will start in a horizontal and central 
position regardless of the resolution of the screen: 

racketPosition.x = screenWidth / 2; 

In the next line of code, racketPosition . y is put at the bottom of the screen with a 
small 20-pixel gap: 

racketPosition . y = screenHeight - 20; 

We make the width of the racket to one-eighth the width of the screen. We will see 
when we get to run the game that this is a fairly effective size, but we could make 
it bigger by dividing it by a lower number, or smaller by dividing it by a larger 
number. The point is that it will be the same fraction of screenWidth regardless 
of the resolution of the device: 

racketWidth = screenWidth / 8; 


ket: 


racketHeight = 10; 

Then we make our ball as small as 1/ 35th of the screen. Again, we could make it 
larger or smaller: 

ballwidth = screenWidth / 35; 

position of 
the ball: 

ballPosition = new Point (); 

As we did with the racket, we start the ball in the center of the screen, like this: 

ballPosition . x = screenWidth / 2; 

see the top of 
the ball: 

ballPosition . y = 1 + ballwidth; 
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The player starts the game with three lives: 

lives = 3; 

en we will 
move on to phase 2. 

Phase 2 - SquashCourtView part 1 

Finally, we get to the secret weapon of our game — the SquashCourtView class. 

The first three methods are presented here, and explained more fully once we 
have implemented them: 

1. Here is a class declaration that extends Surf aceview, giving our class all 
the methods and properties of Surf aceView. It also implements Runnable, 
t the 

bulk of the functionality in the run method. After the declaration, we have 
me 

name as the class and is called when we initialize a new object of its type. 
The code in the constructor initializes some objects and then sends the ball 
have 

y 

brace of the MainActivity class: 

class SquashCourtView extends SurfaceView implements Runnable { 
Thread ourThread = null; 

Surf aceHolder ourHolder; 
volatile boolean playingSquash; 

Paint paint; 

public SquashCourtView (Context context) { 
super (context) ; 
ourHolder = getHolderO; 
paint = new Paint () ; 
balllsMovingDown = true; 

/ /Send the ball in random direction 
Random randomNumber = new RandomO; 
int ballDirection = randomNumber . nextlnt (3 ) ; 
switch (ballDirection) { 
case 0 : 

balllsMovingLef t = true; 
balllsMovingRight = false; 
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break ; 
case 1 : 

balllsMovingRight = true; 
balllsMovingLef t = false; 
break ; 

case 2 : 

balllsMovingLef t = false; 
balllsMovingRight = false; 
break ; 

} 


2. Now we have this short and sweet overriding of the run method. Remember 
that the run method contains the functionality of the thread. In this case, it 
has three calls, one to each of updateCourt, drawCourt, and controlFPS, the 
three key methods of our class. Enter this code: 

©Override 

public void run ( ) { 

while (playingSquash) { 
updateCourt ( ) ; 
drawCourt ( ) ; 
controlFPS ( ) ; 


3. We will implement just one more method in this phase (updateCourt), 
but it is quite long. We will split it into chunks and briefly mention what is 


11 

as detecting and reacting when the ball hits either the left or the right of the 
screen. Enter the following code after the code from the previous step: 
public void updateCourt ( ) { 

if (racket I sMovingRight ) { 

racketPosition . x = racketPosition . x + 10; 

} 


if (racketlsMovingLef t) { 
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racketPosition . x = racketPosition . x - 10; 

} 


//detect collisions 
//hit right of screen 

if (ballPosition . x + ballWidth > screenWidth) { 
balllsMovingLef t = true; 
balllsMovingRight = false; 
soundPool . play ( samplel , 1, 1 , 0, 0, 1) ; 

} 

//hit left of screen 
if (ballPosition . x < 0) { 

balllsMovingLef t = false; 
balllsMovingRight = true; 
soundPool .play (samplel , 1, 1 , 0 , 0, 1) ; 

} 

4. In this next chunk of code, we check whether the ball has hit the bottom of 
the screen, that is, the player has failed to return the ball. Enter this code 
directly after the code in the previous step: 

//Edge of ball has hit bottom of screen 

if (ballPosition . y > screenHeight - ballWidth) { 
lives = lives - 1; 
if (lives == 0) { 
lives = 3; 
score = 0; 

soundPool .play (sample4 , 1, 1, 0, 0, 1) ; 

} 

ballPosition . y = 1 + ballWidth; //back to top of 
screen 

//what horizontal direction should we use 
//for the next falling ball 
Random randomNumber = new Random ( ) ; 
int startX = 

randomNumber . next Int (screenWidth - 
ballWidth) + 1; 

ballPosition . x = startX + ballWidth; 

int ballDirection = 

randomNumber . nextlnt (3 ) ; 
switch (ballDirection) { 
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case 0 : 

balllsMovingLef t = true; 
balllsMovingRight = false; 
break ; 

case 1 : 

balllsMovingRight = true; 
balllsMovingLef t = false; 
break ; 


case 2 : 

balllsMovingLef t = false; 
balllsMovingRight = false; 
break ; 



5. In this chunk of code, we handle whether the ball has hit the top of the screen. 
We also calculate all the possible movements of the ball for this frame. Now 
type the following code: 

//we hit the top of the screen 

if (ballPosition.y <= 0) { 

balllsMovingDown = true; 
balllsMovingUp = false; 
ballPosition.y = 1; 

soundPool . play ( sample2 , 1, 1, 0, 0, 1) ; 


//depending upon the two directions we should 

//be moving in adjust our x any positions 

if (balllsMovingDown) { 
ballPosition.y += 6; 

} 

if (balllsMovingUp) { 

ballPosition.y -= 10; 

} 

if (balllsMovingLef t) { 
ballPosition . x -= 12; 

} 

if (balllsMovingRight) { 
ballPosition . x += 12; 

} 
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6. Finally, we handle collision detection and the reaction of the racket and the 
ball. We also close the updateCourt method, and this is the last chunk of code 
for this phase. Enter the following after your code from the previous step: 
//Has ball hit racket 

if (ballPosition . y + ballWidth >= 

(racketPosition.y - racketHeight / 2)) { 

int halfRacket = racketWidth / 2; 
if (ballPosition . x + ballWidth > 

(racketPosition.x - halfRacket) 

&& ballPosition . x - ballWidth < 

(racketPosition.x + halfRacket)) { 
//rebound the ball vertically and play a sound 
soundPool .play (sample3 , 1, 1, 0, 0, 1) ; 
score++ ; 

balllsMovingUp = true; 
balllsMovingDown = false; 

//now decide how to rebound the ball 
horizontally 

if (ballPosition . x > racketPosition.x) { 
balllsMovingRight = true; 
balllsMovingLef t = false; 

} else { 

balllsMovingRight = false; 
balllsMovingLef t = true; 

} 


Phase 2 code explained 

The code in this phase was lengthy, but there is nothing too challenging when we 
ose nested i f 

statements. We will do this now. 

In step 1, we declare our SquashCourView class. This implements the Runnable 
interface. You might remember from Chapter 5, Gaming and Java Essentials, that 
Runnable provides us with a thread. All we need to do is override the run method, 
and whatever is within it will work in a new thread. 
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Then we created a new Thread object called ourThread, and a Surf aceHolder object 
to hold our surface and enable us to control or lock our surface for use within our 
thread. Next, we have playingSquash of the boolean type. This wraps the inside of 
our overridden run method to control when the game is running. The odd-looking 
volatile modifier means that we will be able to change its value from the outside 
and inside of our thread. 

Lastly, for the currently discussed block of code, we declare an object of the Paint 
type, called paint, to do our painting: 

class SquashCourtView extends SurfaceView implements Runnable { 

Thread ourThread = null; 

Surf aceHolder ourHolder; 
volatile boolean playingSquash; 

Paint paint; 


alized a new 

SquashCourtView object back in onCreate, this is the code that runs. First, we see 
that we run the constructor of the superclass. Then we initialize ourHolder using the 
getHolder method. Next, we initialize our paint object: 

public SquashCourtView (Context context) { 
super (context) ; 
ourHolder = getHolder (); 
paint = new Paint () ; 

Now, still within the constructor, we get things moving. We set our 
bal 1 1 sMovingDown variable to true. At the start of each game, we always want 
the ball to be moving down. We will see soon that the updateCourt method will 
direction, 
tch for 

each possible case: 0, 1, or 2. In each case statement, we set the Boolean variables that 
control horizontal movement differently. In case 0, the ball moves left, and in case 
l and case 3, the ball will move right and straight down, respectively. Then we 
close our constructor: 

bal II sMovingDown = true; 

/ /Send the ball in random direction 
Random randomNumber = new Random () ; 
int ballDirection = randomNumber . nextlnt (3 ) ; 
switch (ballDirection) { 
case 0 : 

balllsMovingLef t = true; 
balllsMovingRight = false; 
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break ; 
case 1 : 

balllsMovingRight = true; 
balllsMovingLef t = false; 
break ; 

case 2 : 

balllsMovingLef t = false; 
balllsMovingRight = false; 
break ; 

} 


In step 2, we have some really simple code, but this is the code that runs everything 
else. The overridden run method is what ourThread calls at defined intervals. As 
you can see, the code is wrapped in a while block controlled by our playingSquash 
variable of the boolean type. Then the code simply calls updateCourt, which controls 
movement and collision detection; drawCourt, which will draw everything; and 
controlFPS, which will lock our game to a consistent frame rate. That's it for run: 

©Override 

public void run ( ) { 

while (playingSquash) { 
updateCourt ( ) ; 
drawCourt ( ) ; 
controlFPS ( ) ; 


Then in step 3, we begin the updateCourt method. It was quite long, so we 
broke it down into a few manageable chunks. The first two if blocks check to see 
whether either the racket IsMovingRight or the racketlsMovingLef t Boolean 
variables is true. If one of them is true, the blocks add l o to or subtract l o from 
racketPosition . x. The effect of this will be seen by the player when the racket is 
drawn in the drawCourt method. How the Boolean variables are manipulated in the 
onTouchEvent method will be discussed soon: 

public void updateCourt ( ) { 

if (racket IsMovingRight) { 

racketPosition . x = racketPosition . x + 10; 
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} 

if (racketlsMovingLef t) { 

racketPosition . x = racketPosition . x - 10; 

} 


Now, still in the updateCourt method, we detect and handle collisions with the 
left and right side of the screen. Checking whether ballPosition . x is larger than 
screenWidth would be enough to see whether the ball bounces back the other way. 
However, by being a bit more precise and testing for ballPosition. x + ballwidth 
> screenWidth, we are testing whether the right edge of the ball hits the right side 
of the screen. This creates a much more pleasing effect as it looks more real. When a 
our ball and 

play a sound. The reason that the i f code for the left-side detection is simpler is 
because we have drawn the ball using drawRect, so ballPosition. x is the precise 
ply reverse its 

direction and play a beep sound: 

//detect collisions 

//hit right of screen 

if (ballPosition . x + ballwidth > screenWidth) { 
balllsMovingLef t = true; 
balllsMovingRight = false; 
soundPool .play (samplel , 1, 1, 0, 0, 1) ; 

} 

//hit left of screen 

if (ballPosition . x < 0) { 

balllsMovingLef t = false; 
balllsMovingRight = true; 
soundPool .play (samplel , 1, 1, 0, 0, 1) ; 

} 


In step 4, we implemented what happens when the ball hits the bottom of the 
screen. This occurs when the player fails to return the ball, so a fair few things need 
tion. First 
hit the 

bottom of the screen: 

//Edge of ball has hit bottom of screen 
if (ballPosition . y > screenHeight - ballwidth) { 


[ 271 ] 



Retro Squash Game 


If it has hit, we deduct a life. Then we check whether the player has lost all their lives: 

lives = lives - 1; 
if (lives == 0) { 

If all lives are lost, we start the game again by resetting lives to 3 and score to 0. We 
also play a low beep sound: 

lives = 3; 
score = 0; 

soundPool . play ( sample4 , 1, 1, 0, 0, 1) ; 

} 

As of now, we are still within the if block because the ball hit the bottom of the 
screen, but outside the i f block for the player who has zero lives. Whether the 
all back at the 

top of the screen and send it in a downward trajectory and a random horizontal 
direction. This code is similar to but not the same as the code we have seen in the 
constructor to start the ball moving at the beginning of the game: 

ballPosition . y = 1 + ballWidth; //back to top of screen 

/ /what horizontal direction should we use 

//for the next falling ball 

Random randomNumber = new Random () ; 

int startX = randomNumber . nextlnt (screenWidth - ballWidth) + 1; 
ballPosition . x = startX + ballWidth; 

int ballDirection = randomNumber . nextlnt (3 ) ; 
switch (ballDirection) { 
case 0 : 

balllsMovingLef t = true; 
balllsMovingRight = false; 
break ; 

case 1 : 

balllsMovingRight = true; 
balllsMovingLef t = false; 
break ; 

case 2 : 

balllsMovingLef t = false; 
balllsMovingRight = false; 
break ; 

} 

} 
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In step 5, we handle the event of the ball hitting the top of the screen. Reverse the 
values held by balllsMovingDown and balllsMovingUp to reverse the direction of 
the ball. Tweak the ball position with bal 1 Posit ion. y = l. This stops the ball from 
getting stuck and plays a nice beep: 

//we hit the top of the screen 

if (ballPosition . y <= 0) { 

balllsMovingDown = true; 
balllsMovingUp = false; 
ballPosition . y = 1; 

soundPool .play (sample2 , 1 , 1 , 0 , 0, 1) ; 

} 


ean variables, 
subtract from 

the ballPosition. x and bal 1 Posit ion. y accordingly. Notice that the ball travels 

yer is waiting 

eration after the 

ball is hit by the racket: 

//depending upon the two directions we should be 
//moving in adjust our x any positions 
if (balllsMovingDown) { 
ballPosition . y += 6; 

} 

if (balllsMovingUp) { 

ballPosition . y -= 10; 

} 

if (balllsMovingLef t) { 
ballPosition . x -= 12; 

} 

if (balllsMovingRight) { 
ballPosition . x += 12; 

} 



You might have noticed that by hardcoding the number of pixels 
the ball moves, we create an inconsistent speed for the ball between 
t 

questions at the end of the chapter to see how we can solve this. 


] 
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racket? This 
erside of the 

ball has reached or gone past the top side of the racket: 

if (ballPosition . y + ballwidth >= (racketPosition . y - racketHeight / 
2 ) ) { 

If this condition is true, we perform some more tests. First, we declare and initialize 
an int variable called half Racket to hold half the width of the racket. We will use 
this in the upcoming tests: 

int halfRacket = racketWidth / 2; 

The next i f block checks whether the right-hand side of the ball is greater than the 
AND operator 

(&&), the block verifies that the ball's left edge is not past the far right of the racket. 

If this condition is true, we definitely have a hit and can think about how to handle 
the rebound: 

if (ballPosition . x + ballwidth > (racketPosition . x - halfRacket) 

&& ballPosition . x - ballwidth < (racketPosition . x + halfRacket)) { 

The first bit of code inside the if block, which determined a definite hit, is simple, 
ory, like this: 

//rebound the ball vertically and play a sound 

soundPool .play (sample3 , 1, 1, 0, 0, 1) ; 
score++ ; 

balllsMovingUp = true; 
balllsMovingDown = false; 

Now we have an if-else condition, which simply checks whether the left-hand 
edge of the ball is past the center of the racket. If it is, we send the ball to the right. 
Otherwise, we send the ball to the left: 

//now decide how to rebound the ball horizontally 
if (ballPosition . x > racketPosition . x) { 
balllsMovingRight = true; 
balllsMovingLef t = false; 

} else { 

balllsMovingRight = false; 
balllsMovingLef t = true; 
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Phase 3 - SquashCourtView part 2 

In this phase, we will complete our SquashCourtView class. There are two methods 
remaining that are called from the run method, drawCourt and controlFPS. Then 
hods that we 

will implement in the fourth and final phase: 

1. Here is the code that draws, in the following order, the text at the top of the 
screen, the ball, and the bat. All is contained within the drawCourt method, 
which is called from the run method, right after the call to updateCourt. 
Here is the code for drawCourt. Type the following code before the closing 
curly brace of the SquashCourtView class: 
public void drawCourt () { 

if (ourHolder . getSurf ace ( ) . isValid ( ) ) { 

canvas = ourHolder . lockCanvas () ; 

//Paint paint = new Paint (); 

canvas . drawColor (Color . BLACK) ; //the background 
paint . setColor (Color . argb (255 , 255, 255, 

255) ) ; 

paint . setTextSize (45 ) ; 

canvas . drawText (" Score : " + score + " 

Lives:" + lives + " fps : " + fps, 20, 40, 
paint) ; 


/ /Draw the squash racket 
canvas . drawRect ( racketPosition . x - 
(racketWidth / 2) , 

racketPosition . y - ( racketHeight / 2), 

racketPosition . x + (racketWidth / 2), 
racketPosition . y + racketHeight, 
paint) ; 

//Draw the ball 

canvas . drawRect (ball Posit ion . x, 
bal 1 Posit ion . y, 

ballPosition . x + ballWidth, ballPosition . y 
+ ballWidth, paint) ; 


ourHolder . unlockCanvasAndPost (canvas) ; 

} 


} 
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2. And now the controlFPS method locks our frame rate to something 
smooth and consistent. We will soon go through its exact working. 
Type the following code after the code in the previous step: 
public void controlFPS () { 

long timeThisFrame = 

(System. currentTimeMillis ( ) - lastFrameTime); 
long timeToSleep = 15 - timeThisFrame; 
if (timeThisFrame > 0) { 

fps = (int) (1000 / timeThisFrame) ; 

} 

if (timeToSleep > 0) { 

try { 

ourThread. sleep (timeToSleep) ; 

} catch ( InterruptedException e) { 

} 


lastFrameTime = System. currentTimeMillis () ; 

} 

3. Next, we write the code for pause and resume. These are called by their 
related Android lifecycle methods (onPause and onResume). We ensure 
that our thread is ended or started safely when the player has finished or 

previous step: 

public void pause () { 

playingSquash = false; 
try { 

ourThread . j oin ( ) ; 

} catch (InterruptedException e) { 

} 


} 

public void resume ( ) { 

playingSquash = true; 
ourThread = new Thread (this) ; 
ourThread . start ( ) ; 

} 
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4. Finally, we have the method that controls what happens when the player 
touches our customized Surf aceView. Remember that when we discussed 

ght 

will move the racket to the right. Type the following code after the code in 
the preceding step: 

©Override 

public boolean onTouchEvent (MotionEvent motionEvent) { 

switch (motionEvent . getAction ( ) & 

MotionEvent . ACTION_MASK) { 

case MotionEvent .ACTION_DOWN : 

if (motionEvent . getX ( ) >= screenWidth / 

2 ) { 

racket I sMovingRight = true; 
racketlsMovingLef t = false; 

} else { 

racketlsMovingLef t = true; 
racket I sMovingRight = false; 

} 


break; 


case 


} 


MotionEvent . ACTIONJJP : 
racket I sMovingRight = false; 
racketlsMovingLef t = false; 
break ; 


return true; 
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Phase 3 code explained 

In step 1, we do all the drawing. We have seen what all the different drawing methods 
of the Canvas class can do, and their names are self-explanatory as well. However, the 
manner in which we arrived at the coordinates needs some explanation. First, inside 
drawCourt, we use ourHolder to get a drawing surface, and we check its validity 
(usability). Then we initialize our canvas and paint objects: 

public void drawCourt ( ) { 

if (ourHolder . getSurf ace (). isValid () ) { 

canvas = ourHolder . lockCanvas () ; 

//Paint paint = new Paint (); 

Next, we clear the screen from the previous frame of drawing: 

canvas . drawColor (Color . BLACK) ;//the background 

Now we set the paint color to white: 

paint . setColor (Color . argb (255 , 255, 255, 255)); 

This is new but simple to explain— we set a size for our text: 

paint . setTextSize (45) ; 

Now we can draw a line of text at the top of the screen. It shows the score and 
livesows 

the value of the fps variable. We will see how we can assign a value to that when 
we look at the next method, controlFPS: 

canvas . drawText (" Score : " + score + " Lives:" + lives + " fps:" + 
fps, 20, 40, paint); 

Then we draw the racket. Notice that we calculate the x start position by 
subtracting half the racket width from racketPosition . x, and the x end position 
by adding the width to x. This makes our collision detection code simple because 
racketPosition . x refers to the center of the racket: 

/ /Draw the squash racket 

canvas . drawRect (racketPosition . x - (racketWidth / 2), 
racketPosition . y - ( racketHeight / 2), 

racketPosition . x + (racketWidth / 2), 
racketPosition . y + racketHeight, paint); 
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Next, we draw the ball. Notice that the starting x and y coordinates are the same 
as the values held in ballPosition.x and ballPosition.y. Therefore, these 
what we 

need for our simple collision detection code: 

//Draw the ball 

canvas . drawRect (ballPosition.x, ballPosition.y, 
ballPosition.x + ballWidth, ballPosition.y + 
ballWidth, paint) ; 

This final line draws what we have just done to the screen: 

ourHolder . unlockCanvasAndPost (canvas) ; 

} 


f times we 
works. 

First, we enter the controlFPS method when it is called from the run method. We 
declare and initialize a long variable with the time in milliseconds, and then take 
ulated in the 

previous run through this method, at the end, as we will see: 
public void controlFPS () { 

long timeThisFrame = (System. currentTimeMillis ( ) - lastFrameTime) ; 

ze that 

value to timeToSleep, a new long variable. Here is how the calculation works: 15 
milliseconds of pause gives us around 60 frames per second, which works well for 
our game and provides a very smooth animation. Therefore, 15 - timeThisFrame 
equals the number of milliseconds we should pause for to make the frame last for 
15 milliseconds: 

long timeToSleep = 15 - timeThisFrame; 

t to pause 
when 

timeThisFrame is equal to zero. Next, we wrap the calculation of frames per second 
within an if statement that prevents us from dividing by zero or a negative number: 

if (timeThisFrame >0) { 

fps = (int) (1000 / timeThisFrame) ; 

} 
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r cautionary 
if statement: 

if (timeToSleep > 0) { 

try { 

ourThread. sleep (timeToSleep) ; 

} catch ( InterruptedException e) { 

} 


Finally, we see how we initialize lastFrameTime, ready for the next time 
controlFPS is called: 

lastFrameTime = System. currentTimeMillis () ; 

} 

In step 3, we quickly implement two methods. They are pause and resume. 

These are not to be confused with the Android Activity lifecycle methods called 
onPause and onResume. However, the pause and resume methods are called from 
their near-namesakes. They handle stopping and starting ourThread, respectively, 
even after 

the activity has finished: 

public void pause () { 

playingSquash = false; 
try { 

ourThread . j oin ( ) ; 

} catch (InterruptedException e) { 

} 


} 

public void resumed { 

playingSquash = true; 
ourThread = new Thread (this) ; 
ourThread . start ( ) ; 

} 


r 

racketlsMovingLef t and racket I sMovingRight Boolean variables, which the 
updateCourtt, 

or to keep it still. We have talked about the onTouchEvent method before, but let's 
see how we set the values in those variables. 
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ex, y 

coordinates of the event: 

©Override 

public boolean onTouchEvent (MotionEvent motionEvent) { 

switch (motionEvent . getAction ( ) & MotionEvent . ACTION_MASK) { 

If the event type is action_down, that is, the screen has been touched, we enter 
this case: 

case MotionEvent .ACTION_DOWN : 
the screen 

with an x coordinate greater than screenWidth / 2, then it means they have 
touched the right-hand side of the screen, so we set isMovingRight to true and 
isMovingLef t to false. The updateCourt method will handle changes in the 
necessary coordinates, and the drawCourt method will draw the racket in the 
appropriate place: 

if (motionEvent . getX ( ) >= screenWidth / 2) { 

racket IsMovingRight = true; 
racketlsMovingLef t = false; 


The else a 

touch must have occurred on the left of the screen: 

} else { 

racketlsMovingLef t = true; 
racket IsMovingRight = false; 

} 


break ; 

Now we handle the case for the action_up event. But why do we care about 
two events? With the buttons, we just cared about a click and that was all, but by 
handling the action up event, we can enable the functionality that allows our player 
ection Tire design of 

the game of this chapter. Thus, the action_down case sets the racket moving one way 
or the other, and the action_up case simply stops the slide completely: 

case MotionEvent .ACTION_UP : 

racket IsMovingRight = false; 
racketlsMovingLef t = false; 
break ; 
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return true; 

} 


Notice that we don't care about the y coordinate. Anywhere on the left we go left, 
anywhere on the right we go right. 



Notice also that all of the code will work whether a device is held 
in the portrait or landscape form, and will function the same 
regardless of the resolution of the device. However (and it is quite 
an important "however"), the game will be slightly harder on low- 
resolution screens. The solution to this problem is quite complicated 
and will not be discussed until the final chapter, but it might well 
help us make some decisions about the future path to learn Android, 
gaming, and Java. 


Phase 4 - Remaining lifecycle methods 

We are nearly there; just a few more steps and we will have a working retro squash 
game. I can almost smell the nostalgia! As these remaining methods are quite 
straightforward, we will explain them as we write them: 

1. As we previously learned, the onstop method is called by the Android 

iy 

o so 

with the line highlighted. Enter the following code before the closing curly 
brace of the MainActivity class: 

@Override 

protected void onStop () { 

super . onStop ( ) ; 

while (true) { 

squashCourtView. pause ( ) ; 

break; 

} 


} 


finish ( ) ; 
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2. The onPause method is called by the Android system when the app is 
paused. This too is implemented for us already, and the only reason we 

the line highlighted. Enter this code after the preceding code: 

©Override 

protected void onPause ( ) { 

super . onPause ( ) ; 

squashCourtView. pause () ; 

} 

3. The onResume method is called by the Android system when the app is 
resumed. Again, this method is implemented for us already. The only reason 
we override it here is to ensure that our thread is resumed, and we do so 
with the line highlighted. Enter the following code after the code in the 
previous step: 

©Override 

protected void onResume () { 

super . onResume ( ) ; 

squashCourtView. resume ( ) ; 

} 

4. Finally, we do something completely new. We handle what happens should 
the player press the back button on their device. As you might have guessed, 
there is a method we can override to achieve this— onKeyDown. We pause 
our thread, just as we did in the overridden lifecycle methods, and then call 
finish ( ) , which ends the activity and our app. Enter this code after the code 
in the previous step: 

public boolean onKeyDown ( int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent . KEYCODE_BACK) { 
squashCourtView. pause ( ) ; 
finish ( ) ; 
return true; 

} 

return false; 

} 


e shortest 

phase so far. So why didn't we encapsulate everything? 
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Good object-oriented design 

ented 

actually 

games 

simpler to explain. 

However, when a game becomes more complex and more people work on the code, 
principles of object-oriented programming become more necessary. 

Self-test questions 

Ql) Can you explain how to make ball speed relative between different 
screen resolutions? 

Summary 

I hope you enjoyed animating your first game. You achieved a lot to get to this 
point. You learned not only all the Java topics but also the way the different 
classes of Android can be used to make games relatively simple. 

you 

are ready. 
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The Snake Game 


In this chapter, we will get straight down to designing and implementing a clone of 
the highly addictive Snake game. We will look at the design of the game and learn how 
to animate some bitmaps. Then we will look at a few aspects of the code that are new, 
such as our coordinate system. After that, we will whiz through the implementation of 
the game. Finally, we will look at how we could enhance our game. 

In this chapter, we will cover the following topics: 

• Examine the design of our game 

• Look at the coordinate system of our Snake game 

• Examine the code structure so that when we come to implement the game, 
it will be more straightforward 

• Learn about animation with sprite sheets at the same time as implementing 
the home screen of our game 

• Break the code for the Snake game into manageable chunks and run through 
its full implementation 

• Enhance the game a little 

Game design 

If you haven't played the excellent Snake game before, here is an explanation of how 
it works. You control a very small snake. In our version, there is just a head, one body 
segment, and a tail. Here is a screenshot of our snake, made out of three segments: 



The Snake Game 


The following screenshot shows the three segments individually: 




Now, here is the thing; our snake is very hungry and also a very quick grower. Every 
the apple: 



r of our game 
moving! What 
reen, it dies. 

At fir and 
inevitably 

into himself. This would again result in his demise: 
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Here is 

a sneak peek at what the game will look like after the basic implementation and 
before the enhancements: 



The player controls the snake by tapping on the left or the right side of the screen. 
The snake will respond by turning left or right. The turn directions are relative to the 
e player needs 

to think like a snake — kind of! 

At the end of the chapter, we will also take a brief look at enhancing the game, use 
that enhanced version in the next chapter to publish it to the Google Play Store, and 
add leaderboards and achievements. 

The coordinate system 

on the 

screen, and we used real screen coordinates to detect collisions, bounces, and so on. 
out of necessity, 
jects will also 

get simpler. This might be surprising when we think about the potential of our snake 
to be many blocks long. 
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Keeping track of the snake segments 

To keep track of all the snake segments, we will first define a block size to define a 
e at an (x,y) 
ition within 

our virtual grid. In the game, we define a grid that is 40 blocks wide, like this: 

//Determine the size of each block/place on the game board 
blockSize = screenWidth/40 ; 

So we know that: 

numBlocksWide = 40; 

y dividing 

the height of the screen in pixels by the previously determined value of blockSize 
minus a bit of space at the top for the score: 

numBlocksHigh = ( (screenHeight - topGap )) /blockSize ; 

This then allows us to keep track of our snake using two arrays for x and y coordinates, 
where element zero is the head and the last used element is the tail, a bit like this: 

/ /An array for our snake 
snakeX = new int [200] ; 
snakeY = new int [200] ; 

As long as we have a system for moving the head, perhaps something similar to the 
ake the 

body follow the head: 

/ /move the body starting at the back 
for(int i = snakeLength; i >0 ; i — ) { 
snakeX [i] = snakeX [i-1] ; 
snakeY [i] = snakeY [i-1] ; 

} 

The previous code simply starts at the back section of the snake and creates its 
. It proceeds 

up the body doing the same until everything has been moved to the location of the 
section that used to be just ahead of it. 

and easy. 
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Detecting collisions 

Using our grid based on blocksize, we can detect a collision, for example, with the 
right side of the screen, like this: 

if(snakeX[0] >= numBlocksWide) dead=true; 

The previous code simply checks whether the first element of our array, which holds 
the xame grid 
d bottom before 

we see it during the implementation. 

Detecting the event of the snake bumping into itself is quick too. We just need 
to check whether the first element of our array (the head) is in exactly the same 
position as any of the other sections, like this: 

//Have we eaten ourselves? 

for (int i = snakeLength- 1 ; i > 0; i--) { 

if ( (i > 4) && (snakeX[0] == snakeX [i] ) && (snakeY[0] = = 
snakeY [i] ) ) { 

dead = true; 



Drawing the snake 

multiplied by 

the size in pixels of a block. The blocksize variable handles the entire challenge of 
making the game work on different screen sizes, like this: 

//loop through every section of the snake and draw it 
//a block at a time. 

canvas . drawBitmap (bodyBitmap , snakeX [i] *blockSize, 

(snakeY [i] *blockSize) +topGap, paint) ; 


on will 

work, but they are probably best answered by actually building the game. 

ing from the 
e. 
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The code structure 

e screen. 

The menu screen activity will be called MainActivity, and the game screen activity 
will be called GameActivity. You can find all the completed code files as well as 
all the assets such as images, sprite sheets, and sound files in the chapter 8 /Snake 
folder in the download bundle. 

MainActivity 

signed in the 

Android Studio UI designer. It will consist of an animated snake head, a title, and a 
high score. The player will proceed to GameActivity by tapping anywhere on the 
screen. As we need to accomplish animations and user interactions, even the home 
screen will have a thread, a view object, and methods normally associated with our 
game screens, like this: 

MainActivity . j ava file 
Imports 

MainActivity class 

Declare some variables and objects 
onCreate 

SnakeAnimView class 
Constructor 
Run method 
Update method 
Draw method 
controlFPS method 
pause method 
resume method 
onTouchEvent method 
onStop method 
onResume method 
onPause method 
onKeyDown method 


this 

section, we will implement it line by line. 
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GameActivity 

o the 

ary a lot (as we 

have discussed and as we will see). There are some differences towards the end of 
the structure, most notably, a loadSound method and a conf igureDisplay method, 
are there): 

MainActivity . j ava file 

Imports 

GameActivity class 

Declare some variables and objects 
onCreate 
SnakeView class 
Constructor 
getSnake method 
getApple method 
Run method 
updateGame method 
drawGame method 
controlFPS method 
pause method 
resume method 
onTouchEvent method 
onStop method 
onResume method 
onPause method 
onKeyDown method 
loadSOund method 
conf igureDisplay method 

Tidying up onCreate 

One of the first things you might notice when you examine the code from the 
GameActivity class we will soon implement is just how short the onCreate 
method is: 

©Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

loadSound ( ) ; 

conf igureDisplay ( ) ; 

snakeView = new SnakeView (this) ; 

setContentView ( snakeView) ; 

} 
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We have written two methods, loadSound and conf igureDisplay. They do most 
ur code less 

cluttered. All that is left in onCreate is the initialization of our SnakeView object and 
a call to setContentView. 

We will look in detail at our loadSound and conf igureDisplay methods when we 
implement them. 

ience of 

this type of implementation, we will just go through all of the implementation of 
our game activity in one phase. 

Let's quickly implement the menu screen. 

Animation, sprite sheets, and the Snake 
home screen 

, and a single 

pixel on the blank bitmap we created in Java code. We then displayed the bitmap 
with all of its doodling using the Canvas class. Now we will look at a technique to 
draw two dimensional images, sometimes referred to as sprites. These are made 
from predrawn images. The images can be as simple as a plain pong ball or as 
complex as a glorious two-dimensional character with muscle definition, elaborate 
clothing, weapons, and hair. 

a static 
not only 
it to create 

the illusion of on-the-spot animation. 

Of course, the ultimate combination would be to animate the bitmap both by 
at briefly 

when we look at an enhanced version of this chapter's Snake game, but will not be 
analyzing the code. 

ght 

expect. For example, to draw a snake's tail swishing back and forth, we would 
itions. 

In the following screenshot, the flower's head is towards the left: 


[ 292 ] 



Chapter 8 



In this screenshot, the flower has been flipped: 
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If the two bitmaps were shown one after the other, repeatedly, they would create 
the basic effect of a flower blowing in the wind. Of course, two frames of animation 
roblem with 

these images as well, as we will learn, so we should add in more frames to make the 
animation as life-like as is practical. 

head for 

our game's home screen. How do we get Android to switch between these bitmaps? 

Animating with sprite sheets 

ulate in code. 

This is where sprite sheets come in. The following image shows some frames from 
his time, 
me image, a bit 

like a series of images in a film. Also, notice in the following image that the frames 
are centered relative to each other and are exactly equal in size: 



If we were to actually show the two previous flower images consecutively, they 
ther 

on their stems, which is probably not the effect we were looking for. 
e after 

another, we will create a basic animation. 

So how do we make our code jump from one part of the sprite sheet to the next? 
Each frame is exactly the same size, 64 x 64 pixels in this case, so we just need a way 
on. As each 
one image file 
ss to handle 

this, which is nothing quite as luxurious as a specific sprite sheet class but almost. 

Regarding sprite sheet classes, such a thing does exist, although 
not in the regular Android classes. An API specifically designed 
for two-dimensional games will usually contain classes for sprite 
sheets. We will look at examples of this in the next chapter. 
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The Rect class holds the coordinates of a rectangle. Here, we create a new object of 
the Rect type, and initialize it to start at 0, 0 and end at 63, 63: 

Rect rectToBeDrawn = new Rect(0, 0, 63, 63); 

The Canvas class can then actually use our Rect object to define a portion of a 
previously loaded bitmap: 

canvas . drawBitmap (headAnimBitmap , rectToBeDrawn, destRect, paint); 

The preceding code is much simpler than it looks. First, we see canvas . drawBitmap. 
We are using the drawBitmap method of the Canvas class just as we have before. 
Then we pass headAnimBitmap, which is our sprite sheet containing all the frames 
we want to animate, as an argument. Rect rectToBeDrawn represents the coordinates 
of the currently relevant frame within headAnimationBitmap. destRect simply 
rame, and 

of course, paint is our object of the Paint class. 

All we have to do now is change the coordinates of rectToBeDrawn and control the 

imated home 

screen for our Snake game. 

Implementing the Snake home screen 

the 

rises in this 
actly what 
is going on: 

1. Create a new project of API level 13. Call it Snake. 

2. Make the activity full screen as we have done before, and put your 
graphics into the drawable/mdpi folder. Of course, you can use my 
graphics as usual. They are supplied in the code download in the 
graphics folder of the Snake project. 

3. Here, you will find our MainActivity class declaration and member 
variables. Notice the variables for our Canvas and Bitmap class as well, we 
as the 

number of frames. We also have a Rect object to hold the coordinates of the 
soon. 

Type the following code: 

public class MainActivity extends Activity { 

Canvas canvas ; 
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SnakeAnimView snakeAnimView; 

//The snake head sprite sheet 
Bitmap headAnimBitmap; 

//The portion of the bitmap to be drawn in the current frame 
Rect rectToBeDrawn; 

//The dimensions of a single frame 
int frameHeight = 64; 
int frameWidth = 64; 
int numFrames = 6; 
int frameNumber; 

int screenWidth; 
int screenHeight; 

/ / stats 

long lastFrameTime ; 
int fps; 
int hi ; 

//To start the game from onTouchEvent 
Intent i ; 

4. The following is the implementation of the overridden onCreate method. 
We get the screen dimensions in the usual way. We load our sprite sheet into 
the headAnimBitmap Bitmap. Finally, we create a new SnakeAnimView and 
the 

previous step: 

@Override 

protected void onCreate (Bundle savedlnstanceState) { 
super . onCreate (savedlnstanceState) ; 

//find out the width and height of the screen 
Display display = 

getWindowManager ( ) . getDef aultDisplay ( ) ; 

Point size = new Point () ; 
display .getSize (size) ; 
screenWidth = size.x; 
screenHeight = size.y; 

headAnimBitmap = 

BitmapFactory . decodeResource (getResources ( ) , 

R . drawable . head_sprite_sheet ) ; 


snakeAnimView = new SnakeAnimView (this); 
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setContentView ( snakeAnimView) ; 
i = new Intent (this, GameActivity . class ) ; 


5. Here is the declaration of our Surf aceView class, called SnakeAnimView, 
along with its member variables. Notice that it extends Surf aceView and 
implements Runnable. All its methods follow in the next steps. Type this 
code after the code from the preceding step: 

class SnakeAnimView extends SurfaceView implements Runnable { 
Thread ourThread = null; 

Surf aceHolder ourHolder; 
volatile boolean playingSnake ; 

Paint paint; 

6. Here is the constructor that gets the f rameWidth value by dividing the 
bitmap width by the number of frames, and the f rameHeight value using 
the getHeight method. Type this code after the code from the previous step: 
public SnakeAnimView (Context context) { 

super (context) ; 
ourHolder = getHolderO; 
paint = new Paint () ; 

frameWidth = headAnimBitmap . getWidth ( ) /numFrames ; 
f rameHeight = headAnimBitmap . getHeight () ; 

} 

7. Now we implement the short but crucial run method. It calls each of the 
key methods of this class one after the other. These three methods are 
wing 

code after the code from the preceding step: 

@Override 

public void run() { 

while (playingSnake) { 
update ( ) ; 
draw ( ) ; 
controlFPS ( ) ; 


} 


} 
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8. Here is the update method. It tracks and chooses the frame number 
that needs to be displayed. Each time through the update method, we 
calculate the coordinates of the sprite sheet to be drawn using f rameWidth, 
f rameHeight, and f rameNumber. If you are wondering why we subtract 1 
es, 

bitmaps start their coordinates at 0, 0: 

public void update ( ) { 

//which frame should we draw 

rectToBeDrawn = new Rect (( f rameNumber * f rameWidth) -1 , 

0, (frameNumber * frameWidth +f rameWidth) - 1 , 
f rameHeight) ; 

//now the next frame 
f rameNumber++ ; 

//don't try and draw frames that don't exist 
if ( frameNumber == numFrames) { 

frameNumber = 0 ; //back to the first frame 

} 

} 


9. Next is the draw method, which does nothing new until the end, when 

screenHeight and screenWidth variables by 2. These coordinates are 
then saved in destRect. Both destRect and rectToDraw are then passed 
to the drawBitmap method, which draws the frame required at the location 
required. Type this code after the code from the previous step: 
public void draw ( ) { 

if (ourHolder . getSurface ( ) . isValid ( ) ) { 
canvas = ourHolder . lockCanvas () ; 

//Paint paint = new Paint (); 

canvas . drawColor (Color . BLACK) ;//the background 
paint . setColor (Color . argb (255 , 255 , 255 , 255 )); 
paint . setTextSize ( 150 ) ; 

canvas . drawText (" Snake " , 10 , 150 , paint); 
paint . setTextSize ( 25 ) ; 

canvas . drawText ( " Hi Score:" + hi , 10 , 
screenHeight- 50 , paint); 

//Draw the snake head 

//make this Rect whatever size and location you 
like 
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//(startX, startY, endX, endY) 

Rect destRect = new Rect ( screenWidth/2 - 100 , 
screenHeight/2 - 100 , screenWidth/2+100 , 
screenHeight/2+100) ; 

canvas .drawBitmap (headAnimBitmap , 

rectToBeDrawn, destRect, paint); 

ourHolder . unlockCanvasAndPost (canvas) ; 

} 


10. Our trusty old controlFPS method ensures that our animation appears 
ion of 

timeTosleep is changed to create a 500-millisecond pause between each 
frame. Type the following code after the code from the preceding step: 
public void controlFPS () { 

long timeThisFrame = 

(System. currentTimeMillis ( ) - 
lastFrameTime) ; 

long timeTosleep = 500 - timeThisFrame; 
if (timeThisFrame > 0) { 

fps = (int) (1000 / timeThisFrame) ; 

} 

if (timeTosleep > 0) { 

try { 

ourThread. sleep (timeTosleep) ; 

} catch ( InterruptedException e) { 

} 


lastFrameTime = System. currentTimeMillis () ; 

} 

11. Next are our pause and resume methods, which work with the Android 

code from the previous step: 

public void pause ( ) { 

playingSnake = false; 
try { 

ourThread . j oin ( ) ; 

} catch (InterruptedException e) { 
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public void resume () { 

playingSnake = true; 
ourThread = new Thread (this) ; 
ourThread . start ( ) ; 

} 

12. For our SnakeAnimView class and our onTouchEvent method, which simply 
mg 

code. Obviously, we don't have a GameActivity yet: 

@Override 

public boolean onTouchEvent (MotionEvent 
motionEvent) { 


startActivity (i) ; 
return true; 



13. Finally, back in the MainActivity class, we handle some Android 
lifecycle methods. We also handle what happens when the player 
presses the back button: 

@Override 

protected void onStopO { 
super . onStop ( ) ; 

while (true) { 

SnakeAnimView. pause ( ) ; 
break ; 

} 


} 


finish ( ) ; 


@Override 

protected void onResume () { 

super . onResume ( ) ; 
SnakeAnimView. resume ( ) ; 

} 


@Override 
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protected void onPause ( ) { 

super . onPause ( ) ; 
snakeAnimView . pause ( ) ; 

} 


public boolean onKeyDown ( int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent . KEYCODE_BACK) { 
snakeAnimView . pause ( ) ; 
finish ( ) ; 
return true; 

} 

return false; 

} 

14. Now you must temporarily comment out this line from step 4 to test the 
ment 

the GameActivity class: 

// i = new Intent (this, GameActivity . class ) ; 

15. Test the app. 

16. Uncomment the line from step 14 when we have implemented the 
GameActivity class. Here is our completed home screen: 
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In this exercise, we set up a class that extended Surf aceView, just like we did for 
our squash game. We had a run method, which controlled the thread, as well as an 
updaten 

our sprite sheet. The draw method simply drew to the screen using the coordinates 
calculated by the update method. 

As in the squash game, we had an onTouchUpdate method, but the code this time 
d to detect, 

we added just one line of code to the method. 

Implementing the Snake game activity 

Not all of this code is new. In fact, we have either used most of it before or discussed 
it earlier in the chapter. However, I wanted to present every line to you in order and 
in context with at least a brief explanation, even when we have seen it before. Having 
be prompted to 

add them automatically or we can just press Alt + Enter when needed. 

This way, we can remind ourselves how the whole thing comes together without any 
blanks in our understanding. As usual, I will summarize as we proceed through the 
implementation, and go into a few bits of extra depth at the end: 

1. Add an activity called GameActivity. Select a blank activity when asked. 

2. Make the activity full screen as we have done before. 

3. As usual, create some sound effects or use mine. Create an assets directory 
in the main directory in the usual way. Copy and paste the sound files 
(samplel . ogg, sample2 .ogg, sample3 . ogg, and sample4 .ogg) into it. 

4. Create individual non-sprite-sheet versions of graphics or use mine. Copy 
and paste them in the res/drawable-mdpi folder. 

5. Here is the GameActivity class declaration with the member variables. 

There is nothing new here until we declare our arrays for our snake (snakex 
and snake y). Also, notice our variables used to control our game grid 
(blocksize, numBlocksHigh, and numBlocksWide). Now type this code: 
public class GameActivity extends Activity { 

Canvas canvas ; 

SnakeView snakeView; 

Bitmap headBitmap; 

Bitmap bodyBitmap; 

Bitmap tailBitmap; 
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Bitmap appleBitmap; 

/ / Sound 

//initialize sound variables 
private SoundPool soundPool ; 
int samplel = -1; 
int sample2 = -1; 
int sample3 = -1; 
int sample4 = -1; 

//for snake movement 
int directionOf Travel=0 ; 

//0 = up, 1 = right, 2 = down, 3= left 


int screenWidth; 
int screenHeight ; 
int topGap; 

/ / stats 

long lastFrameTime ; 
int fps; 
int score; 
int hi ; 

//Game objects 
int [] snakeX; 
int [] snakeY; 
int snakeLength; 
int appleX; 
int appleY; 

//The size in pixels of a place on the game board 
int blockSize; 
int numBlocksWide ; 
int numBlocksHigh; 

6. As explained previously, our new, small onCreate method has very little to do 
because much of the work is done in the loadSound and conf igureDisplay 
methods. Type this code after the code from the previous step: 

©Override 

protected void onCreate (Bundle savedlnstanceState) { 
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super . onCreate ( savedlnstanceState) ; 

loadSound ( ) ; 

conf igureDisplay ( ) ; 

snakeView = new SnakeView (this) ; 

setContentView ( snakeView) ; 


7. Here is the class declaration, member variables, and constructor for our 
SnakeView class. We allocate 200 int variables to the snakeX and snakeY 
arrays, and call the get Snake and get Apple methods, which will place an 
ass 

is constructed: 

class SnakeView extends SurfaceView implements Runnable { 
Thread ourThread = null; 

Surf aceHolder ourHolder; 
volatile boolean playingSnake ; 

Paint paint; 

public SnakeView (Context context) { 
super (context) ; 
ourHolder = getHolder ( ) ; 
paint = new Paint () ; 

//Even my 9 year old play tester couldn't 
//get a snake this long 
snakeX = new int [200] ; 
snakeY = new int [200] ; 

//our starting snake 
getSnake ( ) ; 

//get an apple to munch 
getApple ( ) ; 

} 
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8. Here is how we spawn a snake and an apple in our coordinate system. In the 
getSnake method, we place the snake's head in the approximate center of 
the screen by initializing snakeX [0] and snakeY [0] to the number of blocks 
high and wide divided by 2. We then place a body segment and the tail 

1 

code knows that the first segment is a head, the last segment is a tail, and 
everything in between is a body, then that will do. In the getApple method, 
the integer variables appleX and appleY are initialized to random locations 
within our game grid. This method is called from the constructor, as we saw 
time our 
code 

from the previous step: 

public void getSnake (){ 

snakeLength = 3 ; 

//start snake head in the middle of screen 
snakeX [0] = numBlocksWide / 2; 
snakeY [0] = numBlocksHigh / 2; 

//Then the body 
snakeX [1] = snakeX [0]-l; 
snakeY [1] = snakeY [0]; 

//And the tail 

snakeX [1] = snakeX [1]-1; 

snakeY [1] = snakeY [0]; 

} 

public void getApple (){ 

Random random = new Random ( ) ; 

appleX = random . next Int (numBlocksWide- 1 ) +1 ; 

appleY = random . next Int (numBlocksHigh- 1 ) +1 ; 

} 

9. Next comes the run method, which controls the flow of the game. Type the 
following code after the code from the previous step: 

©Override 

public void run ( ) { 

while (playingSnake) { 
updateGame ( ) ; 
drawGame ( ) ; 
controlFPS ( ) ; 
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10. Now we will look at updateGame, the most complex method of the entire 
app. Having said that, it is probably slightly less complex than the same 
method in our squash game. This is because of our coordinate system, which 
leads to simpler collision detection. Here is the code for updateGame. Study it 
carefully, and we will dissect it line by line at the end: 
public void updateGame () { 

/ /Did the player get the apple 

if(snakeX[0] == appleX && snakeY[0] == appleY) { 

/ /grow the snake 
snakeLength++ ; 

/ /replace the apple 
getApple ( ) ; 

//add to the score 

score = score + snakeLength; 

soundPool .play (samplel , 1, 1, 0, 0, 1) ; 

} 

//move the body - starting at the back 
for(int i=snakeLength; i >0 ; i — ) { 
snakeX[i] = snakeX[i-l] ; 
snakeY[i] = snakeY[i-l] ; 

} 

/ /Move the head in the appropriate direction 
switch (directionOf Travel ) { 
case 0 : / / up 
snakeY [0] - - ; 

break ; 

case 1: //right 
snakeX[0] ++; 
break ; 

case 2 : // down 
snakeY [0] ++; 
break ; 

case 3 : //left 
snakeX[0] 
break ; 

} 

/ /Have we had an accident 
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boolean dead = false; 

//with a wall 

if(snakeX[0] == - 1 ) dead=true ; 
if(snakeX[0] >= numBlocksWide) dead = true; 
if(snakeY[0] == - 1 ) dead=true ; 
if(snakeY[0] == numBlocksHigh) dead = true; 
//or eaten ourselves? 

for (int i = snakeLength- 1 ; i > 0; i--) { 

if ( (i > 4) && (snakeX[0] == snakeX [i] ) && 
(snakeY[0] == snakeY[i])) { 
dead = true; 



if (dead) { 

//start again 

soundPool .play (sample4 , 1, 1, 0, 0, 1) ; 
score = 0; 
getSnake ( ) ; 


11. We have worked out where our game objects are on the screen, so now 
we can draw them. This code is easy to understand as we have seen most 
of it before: 

public void drawGame ( ) { 

if (ourHolder . getSurface ( ) . isValid ( ) ) { 

canvas = ourHolder . lockCanvas () ; 

//Paint paint = new Paint (); 

canvas . drawColor (Color . BLACK) ; //the background 
paint . setColor (Color . argb (255 , 255, 255, 255)); 
paint . setTextSize (topGap/2) ; 

canvas . drawText (" Score : " + score + " Hi:" + hi, 

10, topGap-6, paint); 

//draw a border - 4 lines, top right, bottom , left 
paint . setStrokeWidth (3 ) ; //3 pixel border 
canvas . drawLine ( 1 , topGap , screenWidth- 
1 , topGap , paint ) ; 

canvas . drawLine ( screenWidth-1 , topGap , screenWidth- 
1 , topGap+ (numBlocksHigh*blockSize) , paint) ; 
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canvas . drawLine ( screenWidth- 

1 , topGap+ (numBlocksHigh*blockSize) , 1 , topGap+ 
(numBlocksHigh*blockSize) , paint) ; 

canvas . drawLine ( 1 , topGap , 

1 , topGap+ (numBlocksHigh*blockSize) , paint) ; 

//Draw the snake 

canvas . drawBitmap (headBitmap , snakeX [0] *blockSize , 
(snakeY[0] *blockSize) +topGap, paint) ; 

//Draw the body 

for(int i = 1; i < snakeLength- 1 ; i++) { 
canvas . drawBitmap (bodyBitmap , 
snakeX [i] *blockSize, 

(snakeY[i] *blockSize) +topGap, paint) ; 

} 

//draw the tail 

canvas . drawBitmap ( tailBitmap , snakeX [ snake Length - 

1] *blockSize, ( snakeY [snakeLength- 

1] *blockSize) +topGap, paint) ; 

//draw the apple 

canvas . drawBitmap (appleBitmap , appleX*blockSize , 
(appleY*blockSize) +topGap, paint) ; 

ourHolder . unlockCanvasAndPost (canvas) ; 

} 


12. Here is the controlFPS method, unchanged from our squash game's 
controlFPS method, except that we have a different target frame rate. 
Type this code after the code from the preceding step: 
public void controlFPS () { 

long timeThisFrame = (System. currentTimeMillis ( ) - 
lastFrameTime) ; 

long timeToSleep = 100 - timeThisFrame; 
if (timeThisFrame >0) { 

fps = (int) (1000 / timeThisFrame) ; 

} 

if (timeToSleep > 0) { 

try { 

ourThread. sleep (timeToSleep) ; 
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} catch ( InterruptedException e) { 

} 


lastFrameTime = System. currentTimeMillis () ; 

} 

13. Here are our unchanged pause and resume methods. Type the following 
code after the code from the previous step: 
public void pause ( ) { 

playingSnake = false; 
try { 

ourThread . j oin ( ) ; 

} catch (InterruptedException e) { 

} 


public void resume () { 

playingSnake = true; 
ourThread = new Thread (this) 
ourThread . start ( ) ; 


14. Then we have the onTouchEvent method, similar to that of our squash 

is as follows. We switch on the action_up event. This is broadly the same 
the 

right. If it was on the right, we increment directionOfTravel. If it was 
on the left, we decrement directionOfTravel. If you looked carefully at 
the updateGame method, you would have seen that directionOfTravel 

e 

this code after the code from the previous step: 

@Override 

public boolean onTouchEvent (Mot ionEvent motionEvent) { 

switch (motionEvent . getAction ( ) & 

MotionEvent . ACTION_MASK) { 
case MotionEvent .ACTION_UP : 

if (motionEvent . getX ( ) >= screenWidth / 2) { 

/ / turn right 
directionOfTravel ++; 
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//no such direction 

if (directionOfTravel == 4) 

//loop back to 0 (up) 
directionOfTravel = 0; 

} 

} else { 

//turn left 
directionOfTravel- - ; 

if (directionOfTravel == -1) {//no such direction 

//loop back to 0 (up) 
directionOfTravel = 3; 


return true; 

} 


15. Back in the GameActivity class, we now handle the Android lifecycle 
methods and the "back" button functionality. Type this code after the 
code from the preceding step: 

@Override 

protected void onStopO { 
super . onStop ( ) ; 

while (true) { 

snakeView . pause ( ) ; 
break ; 

} 


} 


finish ( ) ; 


@Override 

protected void onResume () { 

super . onResume ( ) ; 
snakeView . resume ( ) ; 

} 


@Override 

protected void onPauseO { 
super . onPause ( ) ; 
snakeView . pause ( ) ; 
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} 

public boolean onKeyDown ( int keyCode, KeyEvent event) { 
if (keyCode == KeyEvent . KEYCODE^BACK) { 

snakeView . pause ( ) ; 


Intent i = new Intent (this, 

MainActivity. class) ; 
startActivity (i) ; 
finish ( ) ; 
return true; 

} 

return false; 

} 

16. Here is our loadSound method, which simply tidies up the onCreate method 
the code 

from the previous step: 

public void loadSound () { 

soundPool = new SoundPool ( 10 , 

AudioManager . STREAM_MUSIC, 0); 
try { 

//Create objects of the 2 required classes 
AssetManager assetManager = getAssetsO; 
AssetFileDescriptor descriptor; 

//create our three fx in memory ready for use 
descriptor = assetManager . openFd (" samplel . ogg" ) ; 
samplel = soundPool . load (descriptor , 0) ; 

descriptor = assetManager . openFd (" sample2 . ogg" ) ; 
sample2 = soundPool . load (descriptor , 0) ; 


descriptor = assetManager . openFd (" sample3 . ogg" ) ; 
sample3 = soundPool . load (descriptor , 0) ; 

descriptor = assetManager . openFd (" sample4 .ogg"); 
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sample4 = soundPool . load (descriptor , 0) ; 


} catch (IOException e) { 

//Print an error message to the console 
Log . e ( "error " , "failed to load sound files); 
} " 


17. Then we have the conf igureDisplay method, which is called from 

onCreate and does the entire setup of bitmaps and screen size calculations, 
the 

code from the previous step: 

public void conf igureDisplay () { 

//find out the width and height of the screen 
Display display = 

getWindowManager ( ) . getDef aultDisplay ( ) ; 

Point size = new Point ( ) ; 
display. getSize (size) ; 
screenWidth = size.x; 
screenHeight = size.y; 
topGap = screenHeight/14 ; 

//Determine the size of each block/place on the game board 
blockSize = screenWidth/40 ; 

//Determine how many game blocks will fit into the 
//height and width 

//Leave one block for the score at the top 
numBlocksWide = 40; 

numBlocksHigh = ( (screenHeight - topGap 
) ) /blockSize ; 

//Load and scale bitmaps 
headBitmap = 

BitmapFactory . decodeResource (getResources ( ) , 

R . drawable . head) ; 
bodyBitmap = 

BitmapFactory . decodeResource (getResources ( ) , 

R . drawable . body) ; 
tailBitmap = 

BitmapFactory . decodeResource (getResources ( ) , 

R . drawable . tail ) ; 
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appleBitmap = 

BitmapFactory . decodeResource (getResources ( ) , 

R . drawable . apple) ; 

//scale the bitmaps to match the block size 
headBitmap = Bitmap . createScaledBitmap (headBitmap , 
blockSize, blockSize, false); 
bodyBitmap = Bitmap . createScaledBitmap (bodyBitmap , 
blockSize, blockSize, false); 
tailBitmap = Bitmap . createScaledBitmap (tailBitmap, 
blockSize, blockSize, false); 
appleBitmap = 

Bitmap . createScaledBitmap (appleBitmap , 
blockSize, blockSize, false); 


18. Now run the app. The game is much more playable on an actual device than 
it is on the emulator. 

We covered the code as we progressed, but as usual, here is a piece-by-piece dissection 
of a few of the more complicated methods, starting with the updateGame method. 

First, we check whether the player has eaten an apple. More specifically, is the 
snake's head in the same grid location as the apple? The if statement checks whether 
this has occurred, and then does the following: 

• Increases the length of the snake 

• Puts another apple on the screen by calling getApple 

• Adds a value to the player's score, relative to the length of the snake, making 
each apple worth more than the previous one 

• Plays a beep 

Here is the code for the actions that we have just described: 

public void updateGame () { 

//Did the player get the apple 

if(snakeX[0] == appleX && snakeYfO] == appleY) { 

//grow the snake 
snakeLength++ ; 

//replace the apple 
getApple ( ) ; 

//add to the score 

score = score + snakeLength; 

soundPool .play (samplel , 1, 1, 0, 0, 1) ; 

} 
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the 

position of the segment in front of it. We do this with a for loop: 

//move the body - starting at the back 
for(int i = snakeLength; i >0 ; i — ) { 
snakeX[i] = snakeX[i-l] ; 
snakeY[i] = snakeY[i-l] ; 

} 

e leading 
rlier. As 

well. Our run 

e head in the 

direction determined by directionOf Travel. As we saw, directionOf Travel is 
manipulated by the player in the onTouchEvent method: 

/ /Move the head in the appropriate direction 
switch (directionOfTravel) { 
case 0 : / / up 

snakeY [0] - - ; 

break ; 

case 1 : // right 

snakeX[0] ++; 
break ; 

case 2 : // down 

snakeY [0] ++; 
break ; 

case 3 : //left 
snakeX[0] 
break ; 

} 

ked at 

h the left wall, 

then right, then top, and then bottom: 

/ /Have we had an accident 
boolean dead = false; 

//with a wall 

if(snakeX[0] == -1) dead=true; 
if(snakeX[0] >= numBlocksWide) dead=true ; 
if (snakeY [0] == - 1) dead=true ; 
if(snakeY[0] == numBlocksHigh) dead=true ; 
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s seemed 
to 

both 

x and y coordinates: 

//or eaten ourselves? 
for (int i = snakeLength- 1 ; i > 0; i--) { 

if ( (i > 4) && (snakeX[0] == snakeX [i] ) && (snakeY[0] 
== snakeY [i] ) ) { 

dead = true; 



If any part of our collision detection code sets dead to true, we simply play a sound, 
set the score to 0, and get a new baby snake: 

if (dead) { 

//start again 

soundPool .play (sample4 , 1, 1, 0, 0, 1) ; 
score = 0; 
getSnake ( ) ; 


Now we take a closer look at the drawGame method. First, we get ready to draw by 
clearing the screen: 

public void drawGame ( ) { 

if (ourHolder . getSurface ( ) . isValid ( ) ) { 
canvas = ourHolder . lockCanvas () ; 

//Paint paint = new Paint (); 

canvas . drawColor (Color . BLACK) ;//the background 
paint . setColor (Color . argb (255 , 255, 255, 255)); 
paint . setTextSize (topGap/2 ) ; 

Now we draw the text for the player's score, just above topGap that we define in 
configureDi splay: 

canvas . drawText ( " Score : " + score + " Hi:" + hi, 10, topGap- 6, 
paint) ; 
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Now, using drawLine, we draw a visible border around our game grid: 

//draw a border - 4 lines, top right, bottom, left 

paint . setStrokeWidth (3 ) ; //4 pixel border 
canvas . drawLine ( 1 , topGap , screenWidth- 
1 , topGap , paint ) ; 

canvas . drawLine ( screenWidth-1 , topGap , screenWidth- 
1 , topGap+ (numBlocksHigh*blockSize) , paint) ; 
canvas . drawLine ( screenWidth- 

1 , topGap+ (numBlocksHigh*blockSize) , 1 , topGap+ 
(numBlocksHigh*blockSize) , paint) ; 
canvas . drawLine ( 1 , topGap , 

1 , topGap+ (numBlocksHigh*blockSize) , paint) ; 

Next, we draw the snake's head: 

//Draw the snake 

canvas . drawBitmap (headBitmap , snakeX[0] *blockSize, 

(snakeY[0] *blockSize) +topGap, paint) ; 

condition of 

the for loop. This starts at l, which means it is not redrawing the head position, and 
ends at snakeLength - l, which means it is not drawing the tail segment. Here is 
the code used to draw the body section: 

//Draw the body 

for(int i = 1; i < snakeLength- 1 ; i++) { 

canvas . drawBitmap (bodyBitmap , snakeX[i] *blockSize, 

(snakeY[i] *blockSize) +topGap, paint) ; 

} 

Here, we draw the tail of the snake: 

//draw the tail 

canvas . drawBitmap ( tailBitmap , snakeX [ snake Length - 

1] *blockSize , (snakeY [snakeLength-1] *blockSize) +topGap, paint) ; 

Finally, we draw the apple as follows: 

//draw the apple 

canvas . drawBitmap (appleBitmap , appleX*blockSize , 
(appleY*blockSize) +topGap, paint) ; 

ourHolder . unlockCanvasAndPost (canvas) ; 
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Next, we will go through the conf igureDi splay method. 

First, we get the screen resolution and store the results in screenWidth and 
screenHeight as normal: 

public void conf igureDisplay ( ) { 

//find out the width and height of the screen 

Display display = getWindowManager ( ) . getDef aultDisplay ( ) ; 

Point size = new Point ( ) ; 

display . getSize ( size) ; 

screenWidth = size.x; 

screenHeight = size.y; 

Here, we define a gap called topGap. It will be a space at the top of the screen and 
saw topGap 

used fairly extensively in the drawGame method. After this, we calculate the width 
and height of the remaining area in blocks: 

topGap = screenHeight / 14 ; 

//Determine the size of each block/place on the game board 
blockSize = screenWidth/4 0 ; 

//Determine how many game blocks will fit into the height and 
width 

/ /Leave one block for the score at the top 
numBlocksWide = 40; 

numBlocksHigh = (screenHeight - topGap ) /blockSize; 

In the following part of the code, we load all our image files into Bitmap objects: 
//Load and scale bitmaps 

headBitmap = BitmapFactory . decodeResource (getResources ( ) , 

R . drawable . head) ; 

bodyBitmap = BitmapFactory . decodeResource (getResources () , 

R . drawable . body) ; 

tailBitmap = BitmapFactory . decodeResource (getResources () , 

R . drawable . tail ) ; 

appleBitmap = BitmapFactory . decodeResource (getResources () , 

R. drawable . apple) ; 

Finally, we scale each bitmap to be the same width and height as blockSize: 

/ /scale the bitmaps to match the block size 

headBitmap = Bitmap . createScaledBitmap (headBitmap, blockSize, 
blockSize, false) ; 

bodyBitmap = Bitmap . createScaledBitmap (bodyBitmap, blockSize, 
blockSize, false) ; 


[ 317 ] 



The Snake Game 


tailBitmap = Bitmap . createScaledBitmap (tailBitmap, blockSize, 
blockSize, false) ; 

appleBitmap = Bitmap . createScaledBitmap (appleBitmap , 
blockSize, blockSize, false); 


game. 

Enhancing the game 

Here is a series of questions and answers to lead us to an improved version of our 
Snake questions, 
a look at the 
new game and the code. 

Self-test questions 

n? Can we 

use a nice light green, grassy background instead of just black? 

Q2) How about some nice flowers? 

Q3) If you're feeling brave, make the flowers sway. Think about what we have 
he animated 

snake head. We just need a few lines of code to control the frame rate separately 
from the game frame rate. 


GameActivity, but it wouldn't be that useful because the subtle tongue movements 
segment? 

Q5) Here is a slightly trickier enhancement. You can't help notice that when the 
hey don't 

look right. Can you fix this? 
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Summary 

This is the end of yet another successful game project. You now know how to create 
and animate sprite sheets to add more realism to our games. Now we have an 
enhanced Snake game. 

In the next chapter, we will see how simple it is to add leaderboards and achievements. 
This will make our game social and compelling by letting the player see the high scores 
and achievements of their friends and compare them with their own. 
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Making Your Game the 

Next Big Thing 


The day has finally come when we can publish our first game. This chapter, despite 

being shorter than others, is probably the longest chapter to complete. It would be 

ved before 

o during the 

and you 

are really tired. 

es are 

hem. If you 

are really determined, have understood all the code until now, are confident with 
fik in this 

chapter completed in about a day. 

As always, the completed code is in the relevant folder in the download bundle, in 
this case the Chapter9 folder. 


account, had to mask some ID numbers within the code with a series of 



about the ids . xml file which is NOT in the code bundle because of 
its confidential nature. However, as you will see in the Setting up the 
Snake project ready for implementation section, it is easy to get your own 
ID codes. Also note that a lot of the work in this chapter involves set 
up that takes place in your developer console. The leaderboards and 
achievements will not function until you have completed the necessary 
steps. However, you can review the entire code in the Chapter9 folder 
and download the enhanced version of the game from Chapter 8, The 
Snake Game, complete with working leaderboards and achievements 
from Chapter 9, Making Your Game the Next Big Thing, from https : / / 
play . google . com/ store/apps/details?id=com.packtpub . 
enhancedsnakegame . enhancedsnakegame. 


Making Your Game the Next Big Tiling 

If you want to implement everything yourself and also want to start with the 
lf-test 

questions from the previous chapter, then grab the EnhancedSnakeGame code from 
the Chapters folder, and update your working project from Chapters. 

In this chapter, you will learn the following topics: 

• How to publish your app 

• Marketing your app, including making it social with leaderboards and public 
achievements 

• Implementing leaderboards and achievements with the Google Play Game 
Services API 

• Looking at what to do next depending on what you want to achieve 

How to publish your app 

n S 

implementing any of the steps: 

1. Create an icon. Exactly how to design an icon is beyond the scope of this book, 
but simply put, you need to create a nice image for each of the Android screen 
density categories. This is easier than it sounds. Using a simple image, such as 
the snake head bitmap, you can customize and download a set from http : // 
romannurik . github . io/AndroidAssetStudio/ icons -launcher . html. 

There are many sites that offer a similar free service. Of course, you can just 
use the images in the enhanced snake project, and skip this step and the next. 

2. Once you have downloaded your . zip file from the preceding link, you can 
simply copy the res folder from within the download to the main folder 
ted. 

3. Before we proceed further, optionally you will need to prepare some 
en 

types, one image should do fine. You will also need an image of dimension 

0 

for a feature graphic. They don't need to be great, but you do need them to 
e 

Chapter9 folder. 

4. Now, unfortunately, you will need to spend $ 25 to open a Google Play 
account. You can sign up at https : / /play . google . com/ apps /publish/. 
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5. Once you have signed up, you can log in to your developer console at the 
same URL as mentioned in the previous step. 

6. Once in your console, click on the + Add new application button: 


ALL APPLICATIONS 


+ Add new application 


7. In the Add New Application dialog, type a name for your application, such 
as Snake Game. Now click on Upload APK. 

8. We now need to make our app into the release version. Open the 
AndroidManifest .xml file and add the highlighted line of code in 
the location shown: 

■capplication 

android: debuggable= "false" 

android: allowBackup="true" 

9. Rebuild your signed APK for the latest version of the Snake game, as 
discussed in Chapter 2, Getting Started with Android. 

10. Now click on Upload your first APK to production. 

11. Now go to your Snake game APK. 

12. Wait for the APK to finish uploading. You can now see your game summary 
of 

the next image. We have a green tick, indicating that the APK has been 
uploaded successfully: 
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13. The next thing we need to do is configure our Store Listing, so click on the 
Store Listing link, just below the APK link. 

14. Write a short description and a long description. Also upload your 
screenshots, feature graphics, and high-resolution icon. 

15. In the Application Type drop-down menu, select Games. In the Category 
drop-down menu. Arcade is probably most appropriate. For Content Rating, 
select Everyone, and for Privacy Policy, click on the checkbox for Not 
submitting a privacy policy at this time. 

16. Add your website and email address to the relevant boxes. 

17. Back at the top of the web page, click on the Save button. 

18. Now we are at the final stage of this guide. Click on the Pricing and 
distribution link. It is just underneath the Store Listing link from step 13. 

19. Click on the Free button at the top of the page. 

20. Click on the checkbox of all the countries you want your game to be listed in. 

21. Scroll down to the bottom of the page and click on the checkboxes for 

Content guidelines and US Export laws. 

22. Click on Save at the top of the page. 

23. Finally, from the Ready to publish drop-down menu at the top right corner 
of the page, click on Publish this app and you are done. 



y Ready to publish ▼ 



Publish this app 



Delete this app 




Congratulations! Your game will be live on Google Play somewhere between the 
next 5 minutes and 24 hours. 

Marketing your app 

The temptation at this stage is to sit back and wait for our game to hit the top 
position in the best-selling apps. This never happens. 


[ 324 ] 



llowing 

continuously: 

Improve it 


Chapter 9 


We have already made quite a few improvements to the Snake game but there 
are many more, such as difficulty settings, music, debugging (did you see the 
occasionally wonky body segments?), settings menu, and so on. You can pay a 
professional to design backgrounds and sprites, or add more sound effects. When 
you have improved your Android and Java skills further, you can rewrite the entire 
game using a smoother engine and call it Version 2. 

Promote it 

can spread 

the word about our app. We can create a page/ profile on all the social media 
uncements, 

challenges (see compulsion). We can create a website to promote our app and 
d a 

message in the app itself asking players to rate it, perhaps pop up a message just 
know and 

everyone who visits our social media/ website to give a rating and leave a review, 
them is 

this: keep doing it. For example, don't create a Facebook page and then expect it to 
omotion. 

Keep the players' level of compulsion 

Besides improving the game in the ways we have briefly mentioned, we need to 
y might 
in our 

Snake game. Each level could have walls in different places and the layouts could 
rray of 

obstacles, draw them on the screen, and detect collisions. Then set a target for the 
ieved. 

llenges. How 
y, and then 

strategically spending that currency to get a chance to continue after they have died? 
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10 by 
Id come 
or levels 
pulsion can 

be added and updated at the same time as we upload our improvements. Nothing 
mentioned in this discussion about compulsion would be unachievable with the 
skills we have learned so far. 

aderboards 

and achievements so that players can compare themselves to their friends and the 
o make it as 

easy as possible to add leaderboards and achievements to games. We will see how 
we can yet again take advantage of other people's hard work. 

into their 

overall Google Play profile. Here is a screenshot of my rather poor Google Play 
achievements profile: 



You might have noticed a few Snake achievements in that lot. This feature makes 
your game potentially even more compelling. 
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spend significant amounts of time trying to make a real business 
out of our humble Snake game. It just serves as a useful example for 
discussion. Also, if we can come up with so many ideas for a game 
this old and simple, then we can surely come up with some really 
amazing stuff for a game we are passionate about. When you have an 
idea you are passionate about, then that would be the time to go for it 
and expand the brief marketing plan we have discussed. 


Adding leaderboards and achievements 

So we know why leaderboards and achievements are a good thing. The first thing 
re table, 
different. 

The achievements, however, deserve some discussion. 

Planning the Snake achievements 

At first, it might seem that a really simple implementation of a really simple game, 
like our Snake game, isn't deep enough to have many, or even any, achievements. 

So what follows is a quick brainstorming session of achievement ideas: 

• Score 10, 25, 50, 100, and so on: Simply unlock achievements at different 
levels of high score. 

• Snake length: Simply unlock achievements at different snake lengths. 

• Cannibal: Unlock an achievement the first time the player collides with their 
own tail segment. 

• Collect x apples in total: Keep a tally of all the apples ever collected, and 
unlock achievements at significant milestones. 

• Play 10, 25, 50, 100 games: Reward the player for keeping on going. Whether 
they win or lose, achievements are unlocked for effort. 

• Treasure hunt: What if there was a hidden spot in every game? It could give 
oints 

5 , 

10, or 20 hidden spots that they find. 
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ord of the 
do this for 

us. These are known as incremental achievements. The number of apples collected in 
nake length, 

are just dependent on the player's performance in any one game, 
ements so 

that we can see how to implement both types. 

We can have five achievements for reaching each of the following snake lengths: 

5, 10, 20, 35, and 50. There can also be five incremental achievements for the total 
number of apples collected. Specifically, the player will get an achievement at 10, 25, 
50, 100, 150, and 250 apples collected. Soon, we will see how to do it. 

h, 

out of the 1,000-point limit per game. As I might come back and add some more 

evements, 

like this: 


Number of eaten apples 

Achievement points 

10 

10 

20 

30 

50 

40 

100 

70 

250 

100 


wn in the 
following table: 


Length of snake 

Achievement points 

5 

10 

10 

30 

25 

40 

35 

70 

50 

100 


e 

own 

different achievements. 
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Step-by-step leaderboards and achievements 

This is probably the longest part of the book to complete. However, once you have 
been through this process, it will be significantly easier the next time you do it. 

Installing the Google Play Services API on your PC 

Services 

classes. This is nice and easy with Android Studio: 

1. Click on the SDK Manager icon in the Android Studio toolbar: 


f i.®'*' 


2. The SDK manager will start. It looks a bit like this: 
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3. Scroll to the very bottom and underneath Extras, you will see Google 

Play Services. Check the box that is shown as highlighted in the following 
screenshot by clicking on it: 

□ Android Support Repository 
□ n Android Support Libra ry 

Google Play services 
] Q Google Repository 
[H □ Google USB Driver 

Q a Intel x86 Emulator Accelerator (HAXM installer) 


4. Now click on the checkbox for Google Repository, just below Google 
Play Services. 

5. Click on Install packages and wait for the packages to download and install. 

6. Save your project and restart Android Studio. 

vices apps. 

Next, we need to set up our developer console to communicate with our app, ready 
for the features we will soon write code for. 

Configuring the Google Play developer console 

ices 
s our 

application, isn't it? Yes, but Google Play is structured in such a way that you create 

ctual games 

tion that will 

om our 

Snake Game: 

1. Log in to your Google Play developer console at https : //play . google . 
com/apps /publish/. 
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2. Click on the Game services tab on the left of the web page. 


A 

'W 

All applications 


Game services 

w 

Financial reports 

o 

Settings 

A 

Alerts 

□ 

Announcements 


3. Now click on the Add a new game button. 

4. Enter Snake as the name of your game and choose Arcade from the 
Category drop-down menu. Now click on Continue. All of this is 
shown in the next screenshot: 


SET UP GOOGLE PLAY GAME SERVICES FOR AN APP 

Do you already use Google APIs in your app? 

I don't use any Google APIs in 
my game yet 

What is the name of your game? 

Snake 

5 of 30 characters 

This is the name that will be displayed to users in Google Play game services 

What kind of game is it? 

Arcade T 

The category helps users browse interesting games. 

Google Play game services use the following APIs: Google Play App State. Google+ API. 
Google Play Game Services and Google Play Game Management 

We will automatically create a project for your game on the Google Developers Console and 
enable the necessary APIs for you. 


Continue 
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5. Now we can configure our game. Type a game description in the Description 
field, and add the same high-resolution icon and feature graphic that we 
added when we uploaded the game. 

6. Click on the Save button at the top of the screen. 

7. Now we will link our Snake Game Services app with our actual Snake game. 
On the left of the web page, click on the Linked apps tab. 




Quests 

Game details 


Linked apps A 


Events 

o 

Achievements 

* 

Leaderboards 

© 

Testing 

A 

Publishing 

A 


8. Google Play Game Services can be used with almost any platform, even 
Apple. We are using it for Android here, so click on the Android button. 



Android 
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9. All we need to do on this screen is click on the Package Name search box and 
click on our Snake game option. 


Package name 

* 1 

Snake game 

com packtpub enhancedsnakegame en 


10. Click on Save and continue at the top of the screen. 

11. We're nearing the end of this phase. Click on Authorize your app now and 
review the information. 


Branding Information 

The following information will be shown to users whenever you request access to their private data using your 
new client ID. 


Product name: 

Snake 

Google account: 

- you 

Link your project to this account's profile and reputation. 

Product logo: 

https://lh6 ggpht.com/G1KFr1QHwDs2ZTptd2AABga7bl 

Update 

'' •j Max size: 120x60 pixels 

Home Page URL: 


Continue | Cancel 
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12. Finally, click on Continue. 


Client ID Settings 
Application type 

• Installed application 

Runs on a desktop computer or handheld device (like Android or iPhone). 

Installed application type 

• Android Learn more 

API requests are sent directly to Google from your clients' Android devices. Google verifies that each 
request originates from an Android application that matches the package name and SHA1 signing 
certificate fingerprint name listed below. 

Package name: 

(Example: com. example) 

com. packt pub. enhancedsnakegame. enhance 


Signing certificate fingerprint (SHA1): 

(Example: 21 : 45:BD:F6: 98:B8: 71 :S0:39:BD: 0E:83:F2: 06: 9B.-ED: 43:SA:C2:1C ) 



Create client | Cancel | 


We now have a Google Game Services app set up, and linked to our Snake game. 

Implementing the leaderboard in the Google Play 
developer console 

Now we need to create our leaderboard in our developer console so that we can later 
interact with it in our Java code: 

1. Log in to your developer console. 

2. Click on Game Services, then on Snake, and then on Leaderboards. 
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3. Now click on Add Leaderboard. This is the NEW LEADERBOARD screen: 


< NEW LEADERBOARD 

English (United States) - en-US 

Save Save and add another leaderboard 


Name 



English (United States) - en-US 

0 of 100 characters 


Score formatting 

Numeric T 

Number of decimal places: 

0 T 

Add customised unit Q 

What it will look like: 

123 , 450,000 

Icon 

512 x 512 
png or jpg 
(optional) 

If no icon is provided, a standard leaderboard icon will be 
shown to the users. 

+ 

Add icon 


Drop image here 





Ordering 

Larger is better Smaller is better 

a 

Limits 

Do not allow scores below this value: 

Do not allow scores above this value: 


a 

a 


Leave fields blank for no limit. 


List order 

1 ofl 



4. This might look like a bit of a marathon ahead, but all we need to do is enter 
a name (snake will do) in the Name field, and we are done. It might seem 
ossible 

to have multiple leaderboards for one game. 

5. Read through all the options. You will see that they are just right for us and 
no further action is required. Click on Save. 

Our leaderboard is now ready to communicate with our Snake app. 
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Implementing the achievements in the Google Play 
developer console 

discussed previously. 

You nts. 

arged 

ength 

achievements, respectively: 

1. Log in to your developer console. Click on Game Services, then on Snake, 
and then on Achievements. 

2. Click on Add Achievement and you will see the New Achievement screen: 


< NEW ACHIEVEMENT Save 

Save and add another achievement 

English (United States) - en-US 


Name 


English (United States) - en-US 

) of 100 characters 



Description 


English (United States) - en-US 


(optional for testing) 



0 of 500 characters 

Icon 


512*512 


png or jpg 


(optional for testing) 

Add icon 


Drop image here 

Incremental achievements 

Are there several steps the user needs to achieve before this achievement is unlocked? 


□ a 

Initial state 

Revealed Hidden 

Points 

5 5 of 1.000 achievement points distributed 

The point value needs to be between 5 and 200 and needs to be a multiple of 5. 

List order 

1 of 1 
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3. As we are implementing the incremental apple achievements, the first thing 
to do is to enter something in the New Achievement form. In the Name field, 
enter Apple Muncher 1. 

4. In the Description field, enter Munch 10 apples. 

5. Click on the Add Icon button and select your preferred 512 x 512 graphic. 

6. Click on the Incremental achievements checkbox and enter 5 in the How 
many steps are needed field. This is because the first achievement is for 
eating 5 apples. This step is shown in the next screenshot: 


Incremental achievements Are there several steps the user needs to achieve before this achievement is unlocked? 

@ a 

How many steps are needed? 

5 Enter a value between 2 and 10.000 Q 


7. Enter 10 for the number of achievement points in the Points field. 

8. Click on Save and repeat steps 2 to 7 four more times for all the apple 
achievements, varying the Name, Description, How many steps are needed?, 
and Points fields as per our plans and tables of values for achievements. 

9. Now we can move on to our snake length achievements. Click on New 
Achievement. In the Name field, enter Super Snake l. 

10. In the Description field, enter Grow your snake to 5 segments. 

11. Click on the Add Icon button and browse to your preferred image. 

12. Finally, enter 10 for the number of achievement points in the Points field. 

13. Click on Save and repeat steps 9 to 13 four more times for each of the snake 
length achievements, varying the Name, Description, and Points fields as 
per our plans and tables of values for achievements. 

We have now set up our achievements, ready to be implemented in code. 

Setting up the Snake project ready for 
implementation 

he Google 
Play servers: 

1. Add this highlighted code to the AndroidManif est . xml file, just before the 
closing </application> tag: 

<meta-data android : name= "com. google . android. gins . games . APP_ID" 
android:value="@string/app_id" / > 
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<meta-data android : name = "com. google . android. gms .version" 

android: value = "@integer/google_play_services_version" / > 


</application> 

2. Create the ids . xml file in the values folder in the Project Explorer. Now you 
need to get your unique code for your game to go to this file. Log in to your 
developer console, click on Game Services, and then click on Snake. Now 
click on Achievements. 

3. Just below your list of achievements is a small Get resources link: 


5 Apple Muncher 5 CgklrJ3indUHEAIQBg 

Learn all about implementing achievements in the developer documen 




4. Click on the Get resources link. 


EXPORT RESOURCES 


Android Objective -C Javascript Text 


<?xml version="1.0" encoding="utf-8”?> 

<!- 

Google Play game services IDs 

Save this file as res/values/games-ids xml in your project 


<resources> 

<string name- ’app_id">^^^^^^^Bcstring> 

<string name="achievement_apple_muncher_1">^^^^^^^^^^H</string> 

■ ■ ... 

■ 

< st ri n g n a m e = " a c h i eve m e nt_a pp I e_m u n c h e r_5 < vstring> 
< string name="achievement_super_snak.e_1">^^^^^^^^^^^B<.'String> 

<string name="achievement_super_ snake_5">^^^^^^^ ^^^^B</stnng> 
<string name- ’leaderboard_snake''?^^^^^^^^^^^^/string> 
</resources> 


Finished 
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5. Copy and paste the code into the ids . xml file. Then click on the Finished 
button in the developer console. 

6. Now we need to get four code files from the Google Play Game Services 
GitHub repository. We will copy and paste the files directly into our project. 

7. Create three new empty files in the j ava folder. Right-click on GameActivity 
in the project explorer and navigate to New | Java class file. Name the new 
file BaseGameActivity. Repeat this step and name the file GameHelper. 
Repeat this once more and name the file GameHelperUtils. 

8. Now we will get the Java code to copy into the three files we just made. 

To get the code for BaseGameActivity. java, visit https : / /github. 
com/playgameservices /android-basic -samples /tree /mas ter/ 
BasicSamples/libraries/BaseGameUtils/src/main/ j ava/ com/google/ 
example / games /basegameut i 1 s, where you can see further links to the code 
for the three files we created in step 7: 


GameHelper bugfix — 

1 geertjan-apptornado authored on 16 Jul 


1 BaseGameActivity java 
@ GameHelper.java 
§1 GameHelperUtils.java 


Addresses various SDK changes that happened between 4.1 and 4.3 as we... 
GameHelper bugfix 

Updating samples to new API programming model (GoogleApiClient). 


9. Click on BaseGameActivity .java as shown in the preceding screenshot, 
file that 

we created in Android Studio. Note that when we created the file. Android 
Studio created some basic template code. We need to delete all of this, except 
o 

delete the Google package name. 

10. Click on GameHelper.java, as shown in the previous screenshot, and 
repeat step 9. 

11. Click on GameHelperUtils.java, as shown in the preceding screenshot, and 
repeat step 9. 

12. There's one more file to create. Right-click on the values folder in the project 
explorer. Navigate to New | File. Name the file gamehelper_strings .xml. 
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13. Get the code that we need for this file in the same way as we did for 
the previous three Java files from but from this link: https : //github . 
com/playgameservices /android-basic -samples /blob/master/ 
BasicSamples/libraries/BaseGameUtils/src/main/ res /values/ 
gamehelper_strings . xml. 

14. Paste the code in gamehelper_strings .xml, which we created in step 12. 

15. Now change the MainActivity declaration in the MainActivity . java file. 
Consider this code: 

public class MainActivity extends Activity { 

Activity that handles all the hard work of the Game Services API: 
public class MainActivity extends BaseGameActivity { 

16. Now check out the code in the GameActivity . j ava file: 
public class GameActivity extends Activity { 

Change the preceding code to the following code so that we can now 
extend the version of Activity that handles all the hard work of the 
Game Services API: 

public class GameActivity extends BaseGameActivity { 

17. Notice that for both Activities, we have an error in the class declaration we 

t 

methods of a class we are using. Recall from Chapter 6, OOP - Using Other 
People's Hard Work, that if a method in a class is declared abstract, then the 

ty 

nd 

navigate to Generate | Implement Methods. Now click on OK. Perform this 
step for the MainActivity. java file and the GameActivity. java file. Our 

next tutorial. 
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18. Next, using the project explorer, find the build . gradle file. Be careful; there 
are two files with the same name. The file that we need to find is a couple 
of lines below the AndroidManif est . xml file. It is highlighted in the next 
screenshot. Open it by double-clicking on the build . gradle file: 

<> ; AndroidManifest.xml 
[=] .gitignore 
build. gradle 

. Enhanced Snake Game. apk 
31 Enhanced Snake Game.iml 
Hj proguard-rules.txt 


19. Find the section of code shown here and add the line that is highlighted. This 
makes all the classes we downloaded in the previous guide available for use 
in our Snake game: 
dependencies { 

compile ' com. google . android. gms : play- services : + 1 

compile ' com . android . support : appcompat-v7 : + 1 
compile f ileTree (dir : 'libs', include: ['*.jar']) 

} 

Okay, I agree that was a fairly tough tutorial, but we are now ready to implement 
our code in three final steps: 

1. Player sign-in and buttons. 

2. Leaderboards. 

3. Achievements. 

rds 

and achievements. 
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Implementing the player's sign-in, achievements, 
and leaderboard buttons 

By the end of this section, players will be able to log in through the game to our 
will 

actually make the leaderboards and achievements work. 

1. First, let's enable our Game Services. All of the work we have done so far in the 
developer console needs to be published before we can use it. Log in to your 
developer console. Navigate to Game Services | Snake | Ready to publish | 
Publish game. Then you will be shown a Publish your game button. Click on 
it. Finally, read the brief disclaimer and click on Publish now. 

2. Now we need to build a UI that has Sign in. Sign out, Leaderboards, and 
Achievements buttons. Open the layout_main.xml file and edit it on the 
Text tab of the editor window by adding the following code. Obviously, 
there is a lot to type. You might like to copy and paste the code from the 
download package at Chapter9\EnhancedSnakeGame\layout. Here is 
the code. Type it in or copy and paste it: 

<RelativeLayout xmlns : android= "http : / /schemas . android . com/apk/res/ 
android" 

xmlns : tools= "http : / /schemas . android . com/ tool s " 
android : layout_width= "match parent " 
android : layout_height= "match_parent " 

android :paddingLeft= "@dimen/activity_horizontal_margin" 
android :paddingRight= "@dimen/ activity_horizontal_margin" 
android :paddingTop= "@dimen/ activity_vertical_margin" 
android :paddingBottom= "@dimen/activity_vertical_margin" 
tools : context= " com . packtpub . enhancedsnakegame . 
enhancedsnakegame . MainActivity" > 

<Button 

android: id="@+id/llPlay" 

android : layout_width= " 140dp" 

android : layout_height= " wrap_content " 

android : text= "Leaderboards " 

android : layout_alignParentBottom= "true " 

android : layout_alignParentRight= " true " 


[ 342 ] 



android : layout_al ignParentEnd= " true " 
android :vi sibil ity= "gone " /> 

<Button 

android : id= "@+id/awardsLink" 

android: layout_width="140dp" 

android : layout_height= "wrap_content " 

android : text= "Achievements " 

android : layout_gravity= " cent er_verti cal " 

android : layout_alignTop= "@+id/llPlay" 

android : layout_toLef tOf = "@+id/llPlay" 

android :vi sibil ity= "gone " /> 


<!-- sign-in button --> 

<com . google . android . gms . common . SignlnButton 
android : id= "@+id/sign_in_button" 
android: layout_width="140dp" 
android : layout_gravity= "center_horizontal 
android : layout_height= " wrap_content " 
android : layout_alignParentTop= " true" 
android : layout_alignParentRight= " true " 
android : layout_alignParentEnd= " true" 

/> 

<!-- sign-out button --> 

<Button 

android : id= "@+id/sign_out_button" 
android: layout_width="140dp" 
android : layout_height= " wrap_content " 
android: text="Sign Out" 
android : layout_alignParentTop= " true" 
android : layout_alignParentRight= " true " 
android : layout_alignParentEnd= " true" 
android : layout_gravity= "center_horizontal 
android :vi sibil ity= "gone " 

/> 


< /Relat iveLayout > 
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3. Explaining the code line by line is beyond the scope of the book, but this is 

the UI designer since Chapter 2, Getting Started with Android. Each block of the 
code in the last step defines a button and its position on the screen. You can 
ote 

that the reason some of the buttons are not visible in the designer is that they 

s 

way is to make sure we implement the sign in button in just the right way. 
Note the id attribute for each of the buttons. We will be manipulating them 
in our Java code next. With some buttons set to visibility = gone, we see 
something like this: 



4. With some buttons set to visibility = visible, we see something like 
what is shown in the following screenshot: 
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5. You might be wondering why we are designing a UI when SnakeAnimView 
is what the user sees. We could have implemented all our own buttons with 
bitmaps and used their screen coordinates to detect presses, but what we will 
do now is load our UI on top of SnakeAnimView, which will greatly simplify 
things. Switch to the MainActivity tab in the editor window. 

6. First of all, we want to implement the onClickListener interface to handle 

public class MainActivity extends BaseGameActivity implements 
View . OnClickListener { 

7. Now we can get Android Studio to quickly implement the required onClick 
method by right-clicking on the class declaration, navigating to Add | 
Implement methods, and then clicking on OK. 

8. Immediately after the previous line of code, we declare our four new buttons. 
Add this code after the code in the previous step: 

//Our google play buttons 
Button llPlay; 

Button awardsLink; 

com . google . android . gms . common . SignlnButton sign_in_button; 
Button sign_out_button; 

9. In the onCreate method, just after the call to the setContent view, we 
use an object of the Layout Inf later class to load our UI on top of our 
SnakeAnimView. Add the highlighted code after the call to setContentView: 
setContentView ( SnakeAnimView) ; 

//Load our UI on top of our SnakeAnimView 
Layoutlnf later mlnflater = Layoutlnf later . from ( this) ; 

View overview = mlnflater . inflate (R . layout . activity main, 
null) ; 

this . addContentView (overview, new 

ViewGroup . LayoutParams (ViewGroup . LayoutParams . MATCH PARENT , 
ViewGroup . LayoutParams . MATCH_PARENT) ) ; 

10. Immediately after the code in the previous step, we can get a reference to all 
our buttons and listen to clicks in the usual way: 

//game services buttons 
sign_in_button = 

(com. google . android . gms . common . SignlnButton) 
f indViewByld (R. id. sign_in_button) ; 
sign_in_button . setOnClickListener (this) ; 
sign_out_button = 

(Button) f indViewByld (R. id. sign_out_button) ; 
sign_out_button. setOnClickListener (this) ; 
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awardsLink = (Button) 

f indViewByld (R. id. awardsLink) ; 
awardsLink. setOnClickListener (this) ; 
llPlay = (Button) findViewByld (R . id . llPlay) ; 
llPlay. setOnClickListener (this) ; 

11. Remember that in the previous guide, we overrode two abstract methods 
that we inherited when we extended the BaseGameActivity class. 

Now we will put some code into their implementation. The code is very 

other 

ir 

entirety. Type the highlighted code within the methods shown: 

©Override 

public void onSignlnFailed ( ) { 

// Sign in failed. So show the sign-in button. 
sign_in_button . setvisibility (View. VISIBLE) ; 
sign out button .setvisibility (View. GONE) ; 

} 


©Override 

public void onSignlnSucceeded ( ) { 

// show sign-out button, hide the sign-in button 
sign_in_button . setvisibility (View. GONE) ; 
sign_out_button .setvisibility (View. VISIBLE) ; 
llPlay. setvisibility (View. VISIBLE) ; 
awardsLink. setvisibility (View. VISIBLE) ; 

} 

12. Now we deal with the onClick method and what happens when the player 
witch 

block. We will fill in the case statements in the next step: 
switch (v.getldO) { 


13. Here, we handle the sign in button. We simply call the 

beginUserlnitiatedSignln method. It is implemented for us in the 
BaseGameActivity class. Type this code in the switch block from the 
previous step: 

case R . id . sign_in_button : 

// start the sign 
beginUserlnitiatedSignln ( ) ; 
break ; 
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14. Now we handle what happens when the player signs out. We just call 
signOut, which is implemented for us in the BaseGameActivity class. 

We then hide all our buttons and show the sign in button again. Type the 
following code after the code from the previous step: 

case R . id . sign_out_button : 

// sign out. 
signOut ( ) ; 

// show sign-in button, hide the sign-out button 
sign_in_button . setVisibility (View . VISIBLE) ; 
sign_out_button . setVisibility (View . GONE) ; 

11 Play . setVisibility (View . GONE) ; 
awardsLink . setVisibility (View . GONE) ; 
break ; 

15. Next, we handle what happens when the player clicks on the achievements 
This is 

s. 

Type this code after the preceding code: 
case R . id . awardsLink : 

startActivityForResult (Games .Achievements . getAchie 
vementslntent (getApiClient ( ) ) , 0) ; 

break ; 

16. Finally, we handle what happens when the player clicks on the Leaderboards 
onality: 

case R.id.llPlay: 

startActivityForResult (Games . Leaderboards . getLead 
erboardlntent (getApiClient ( ) , getResources ( ) . getString (R . string . 
leaderboard_snake) ) , 0) ; 

break ; 

We explained the code as we went, but let's summarize: 

1. We designed a simple UI. 

2. We loaded the UI on top of SnakeAnimView. 

3. We got a reference to our four buttons and listened for clicks. 

4. We handled what happens when people click on our buttons, which 

calling methods from BaseGameActivity, and using the Intent class to 
implement all our leaderboard and achievement functionalities. 
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You can actually run the Snake game and see the leaderboards and achievements 
high scores 

yet. We will fix this now. 

Implementing the leaderboards in code 

Once more, we will witness the simplicity of using other people's well-designed 
code. Admittedly, there was some complexity to arrive at this point, but once you 
have set it all up, then your next game will take a fraction of the time you took 
setting up: 

1. We want to submit a score to the leaderboards at the end of a game. Google 
Google 

Open the GameActivity . j ava file in the code editor window. 

2. Find the updateGame method and add the highlighted code among all the 
other things we do when the game is over (when dead equals true). We 
yer 

is signed in: 
if (dead) { 

if (isSignedln () ) { 

Games . Leaderboards . submitScore (getApiClient ( ) , 

getResourcesO . getString (R . string . leaderboardsnake) , 
score) ; 

} 

3. That's it! Build the game and play it on a real Android device. You can now 
visit the leaderboards on Google Play and see your high score. 
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That was nice and easy. Here, we can see the login screen: 



tD O S ::: ^ sr?,y 14:12 ?■ 


Then comes the welcome message and our Achievements and Leaderboards buttons 
as shown in the following screenshot: 
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Finally, we can see our new leaderboards with just one player —me. 



Just in case you're wondering, I can do a lot better than 39. 

Implementing the achievements in code 

This brief tutorial will first set up our game to post incremental updates to the 

ake 

segment length: 

1. In the GameActivity . j ava file, add an applesMunchedThisTurn variable 
just after the class declaration, as shown here: 

public class GameActivity extends BaseGameActivity { 

int applesMunchedThisTurn; 

2. Find the updateGame method. 

3. Add a line of code to increment applesMunchedThisTurn each time an apple 
is eaten by adding the highlighted line of code where it is shown: 

//Did the player get the apple 

if(snakeX[0] == appleX && snakeY[0] == appleY) { 
applesMunchedThisTurn++ ; 

//grow the snake 
snakeLength++ ; 

//replace the apple 
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getApple ( ) ; 

//add to the score 

score = score + snakeLength; 

soundPool .play (samplel , 1, 1 , 0, 0, 1) ; 


4. Notice that we place this highlighted line among the code that executes when 
the player dies (the if (dead) block). We could do it at the point the player 
eats an apple, but if we send five messages to the Google Play servers every 
time the player eats an apple, we might risk Google considering it as spam. 
We simply increment each achievement by the number of apples that have 
been eaten, and then reset the applesMunchedThisTurn variable to zero. We 
wrap our achievement method calls with a check that the player is signed 
in and that applesMunchedThisTurn is greater than zero. Now add the 
highlighted code: 
if (dead) { 

//start again 
if (isSignedln () ) 

if (applesMunchedTisTurn > 0) {//can't increment zero 

Games .Achievements . increment (getApiClient () , getResourcesO . 
getString (R. string. achievement_apple_muncher_l) , 
applesMunchedThisTurn) ; 

Games .Achievements . increment (getApiClient () , getResourcesO . 
getString (R . string . achievement_apple_muncher_2 ) , 
applesMunchedThisTurn) ; 

Games .Achievements . increment (getApiClient () , getResourcesO . 
getString (R . string . achievement_apple_muncher_3 ) , 
applesMunchedThisTurn) ; 

Games .Achievements . increment (getApiClient () , getResourcesO . 
getString (R . string . achievement_apple_muncher_4 ) , 
applesMunchedThisTurn) ; 

Games -Achievements . increment (getApiClient () , getResourcesO . 
getString (R . string . achievement_apple_muncher_5 ) , 
applesMunchedThisTurn) ; 

applesMunchedThisTurn = 0; 

}//end if (applesMunchedThisTurn > 0) 


Games . Leaderboards . submitScore (getApiClient ( ) , getResources ( ) . 
getString (R. string. leaderboard_snake) , score) ; 

}//end if (isSignedln) 
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soundPool . play ( sample4 , 1, 1, 0, 0, 1) ; 
score = 0; 
getSnake ( ) ; 


5 . 


Now we will handle the segment length achievements. In the updateGame 
method, in the part of the code that executes when the player eats an apple, 
just after the line of code that increments snakeLength, we test for any of the 
lengths that warrant a Super Snake achievement. When the desired length 
rd it (if 
a 

eaten. 

The highlighted code is the new code to add: 


//grow the snake 


snakeLength++ ; 

if (isSignedln () ) { 

if (applesMunchedThisTurn > 0) {//can't increment by zero 
//Are we long enough for a new SuperSnake 
achievement? 


if ( snakeLength == 5) { 

Games .Achievements .unlock (getApiClient () , 
getResources ( ) . getString (R . string . achievement_super_snake_l) ) ; 

} 

if ( snakeLength == 10) { 

Games .Achievements .unlock (getApiClient () , 
getResources ( ) . getString (R . string . achievement_super_snake 2 ) ) ; 

} 

if ( snakeLength == 25) { 

Games .Achievements .unlock (getApiClient () , 
getResources ( ) . getString (R . string . achievement_super_snake 3 ) ) ; 

} 

if ( snakeLength == 35) { 

Games .Achievements .unlock (getApiClient () , 
getResources ( ) . getString (R . string . achievement_super_snake_4 ) ) ; 

} 

if ( snakeLength == 50) { 


Games .Achievements .unlock (getApiClient () , 
getResources ( ) . getString (R . string . achievement_super_snake_5) ) ; 


} 


} 
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6. That's it! You can now play the game and earn achievements: 



tD -o 3 ::: ^ 14:55 ?■ 


be to 
hapter. 

Let's move on and update our game on Google Play. 

Uploading the updated Snake game to Google Play 

This is nice and easy and is performed as follows: 

1. First, we need to let Google Play know this is a new version. We do this by 
changing the version number. Open the Build . gradle file and find these 
lines of code: 

versionCode 1 

versionName "1.0" 

Change them to the following: 
versionCode 2 

versionName "1.1" 

2. Build your APK in the usual way. 

3. Log in to your developer console. 

4. Click on Snake Game 1.0, then on APK, and then on Upload new APK to 
production. 
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5. Go to your newly updated APK. 

6. In the What's new in this version field, enter Added leaderboards and 
achievements. 

7. Click on Publish now to production. 

From now onwards, everyone who downloads your game will get the updated 
version. With our first game, complete with sprite sheet animations, leaderboards 
and achievements, it is time to take a break and do a little theory. 


What next? 

ur first 
still not 

clear, then consider revisiting them after a break, 
d to 

ur initial 

motivation for reading this book. 

Getting a programmer's job 

If you want to be a Java employee, that is, working full time with a professional 

liege 

f 

dy, you could 

consider a more formal Java book, followed by a pure OOP book about object- 
oriented analysis and design. You could then move on to study design patterns. 

Some of the best books that fit into these categories are Head First Object-Oriented 
nd Gary 

Pollice; Head First Design Patterns; Eric Freeman and Elisabeth Robson, O'Reilly; and 
Design Patterns CD: Elements of Reusable Object-Oriented Software, Erich Gamma, 
Richard Helm, Ralph Johnson, and John Vlissides, Addison Wesley. The first two are 
very beginner-friendly. The latter is highly regarded but a much more challenging 
read for a beginner. 

mes and Java 

because you were headed in that direction, so let's consider our piece de resistance so 
far — our Snake game. 
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Building bigger and better games 

If you compare our Snake game to a modern, professional title, even a two-dimensional 
game, never mind a modem big-budget First Person Shooter (FPS), then we still have a 
lot of learning to do. Let's consider some inadequacies of our Snake game compared to a 
professional game. 

Think about our flower and tail animations. They worked because we set up a crude 
timing system within our controlFPS method. But what if we had a dozen or more 
game objects that needed to be animated? 

further 

complicate things if some of the animations need to work on a loop and others need 
to reverse through each frame before restarting. 

frame 

happens to be displayed at the time the player jumps? 
earch and 

some study. The point is that things are starting to get fairly complicated, and we 
have only talked about animation. 

y 

nt and 
re lots of 

objects of different sizes and shapes, some moving fast and some stationary? How 
would we simulate this physics model? 

Again, the answers are all out there but they add complexity. What about other 
environmental factors such as light and shadow? What happens when our screen 
needs to scroll to the left and right? What about up and down? 

Now consider all of these problems and imagine implementing a solution in a virtual 
would take 
the raw 

mathematics involved in three-dimensional calculations. 

Next, imagine that you want your new three-dimensional, physics-based, superbly 
animated game to be available on Android, Apple, and PC platforms. 

If I have discouraged you from seeking some of these solutions but you are 
fascinated to find out the answer, then my advice would be to go and find it out 
anyway. It will definitely be a fascinating journey and make you a better game 
or any 

reason other than curiosity, self-improvement, or fun. 
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The reason for this is because we are not the first people to have these and many 
what? 

We can use those solutions, often at no cost to ourselves. 

For example, there is a library called OpenGL that has one purpose — drawing in a 
three-dimensional coordinate system. It has classes and methods for everything you 
will ever need. There is even a version of OpenGL for mobile, called OpenGL ES, that 
you can program in Java. It is true that OpenGL has some complexities of its own, but 
they can be learned in a logical and straightforward manner from easy to hard. 

If you got this far with this book, take a quick refresher on Chapter 6, OOP - Using 
Other People's Hard Work, and then grab a copy of OpenGL ES2for Android, K. 
Brothaler, Pragmatic Bookshelf. The book explores the code library and some of the 
ely practical 

reader. Alternatively, you can check out loads of free tutorials at http : //www . 
learnopengles . com/. 

t 

va-based 
ild games 

on Android, iPhone, PC, and the Web. 

Indeed, you can build one Java game and it will run on almost any device in the 
world, even a web page. It also has classes that simplify the use of the aforementioned 
OpenGL ES. The library is called LibGDX, and I had loads of fun making a platform 
game following along with Learning Libgdx Game development (https : //www . 
packtpub . com/game -development /learning -libgdx- game -development). 

LibGDX also solves all our animation, scrolling, and physics conundrums without 
any math, although it doesn't really address three-dimensional features. 

Note that both books have some quite in-depth OOP, but this is 
not out of reach if you understood Chapter 6, OOP - Using Other 
People's Hard Work, and are determined. 
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If you want to go 3D straightaway, then a really fun option is the Unreal Engine, 
immense 

two-dimensional and three-dimensional games within a GUI development 
environment, it is probably unbeatable. Unreal Engine 4 uses a system called 
Blueprint, where you can drag and drop elements of flow chart-like elements, 
instead of coding. It still uses all the concepts of OOP as well as loops and branching, 
but you can do loads without a single line of real code. Take a look at the Unreal 

https : / / 

play . google . com/store/apps/details?id=com . epicgames . TappyChicken. 
tely, 

there is a small monthly fee, and most restrictively of all, any commercial project 
you make will be subject to an agreement. Here, you pay 30 percent to Epic games, 
but for learning and having fun, it probably can't be beaten. 

Alternatively, take a look at my blog (www . gamecodeschool . com), where I regularly 
ate game 

programmers. My blog discusses lots of different programming languages, target 
platforms, all the tools previously mentioned, and more. 

Self-test questions 

Ql) Try to implement local high scores on the device. 

Q2) How many eminent computer scientists have made cameo appearances in the 
code throughout this book? 

Q3) As a final challenge, try to beat my high score on the Snake leaderboards. 
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Summary 

In this chapter, we covered a lot. We published our Snake game on Google Play. 

Then we added some online leaderboards and achievements. We also updated our 
publication. The process showed how very complicated tasks such as communication 
over the Internet can be made really simple using an API. 

While putting the finishing touches to this book, I watched a YouTube video of 
the 

development of the Doom game, which was published in June 1995. 1 had to laugh, as 
missing out 

on the technology revolution, and by the time he was old enough to work, it would 
all be over. 

any have 
hn Carmack 

explained that there is always going to be another revolution just around the corner. 

So you are probably going to develop your skills and watch out for the next big 
thing. Or perhaps, you just want a bit of fun programming anything in any language 
for any platform. 

ou will 
you choose 
dge at 

www . gamecodeschool . com. The perfect sequel to this book will be published 
mid 2015 called Android Game Programming by Example. 
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Self-test Questions 
and Answers 


Here, we have included some questions you could ask yourself to see whether you 
have understood each chapter. Don't worry! The answers are also included. 

Chapter 2 

Ql) What should you do if all this talk of life cycles, classes, and methods is a 
bit confusing? 

they are not 

entirely clear at this stage, it will not hold you back from thoroughly learning Java, 
and all will become clearer as we progress. 

Q2) What exactly is a Java class? 

like 

containers for our Java code, and we can even use other people's classes to simplify 
tained 

within those classes. 

Q3) What is the difference between a method and a class? 

A) Methods are contained within classes and represent the specific functionality of the 
class, like another container within a container. As an example from a game, we might 
have a Tank class with shoot, drive, and selfDestruct methods. We can use a class 
and its methods by making our own class, as we will in Chapter 6, OOP - Using Other 
People's Hard Work, or by using the @import statement as we did earlier in this chapter. 



Self-test Questions and Answers 

planation 

of the lifecycle phases, at http : / /developer . android, com/ ref erence/android/ 
app /Activity . html. Can you see the phase and its related method that we haven't 
discussed? When would it be triggered in an app? What is the precise pathway an 
activity takes from creation to destruction? 

A) It's the restarting phase. Its corresponding method is onRestart. It is triggered 
when an app has been stopped and then restarted. We won't need the onRestart 
ept of life 
that are 

relevant to our game. So far, we have just tinkered with onCreate. 

Chapter 3 

Ql) What does this code do? 

// setContentView (R . layout . activity_main) ; 

A) Nothing, because it is commented out with / /. 

Q2) Which of these lines causes an error? 

String a = "Hello"; 

String b = " Vinton Cerf"; 
int c = 55; 
a = a + b 
c=c+c+10; 
a = a + c ; 
c = c + a ; 

A) The fourth line, a = a + b, has no semicolon, so it will cause an error. The last 
line, c = c + a ; , will also cause an error because you cannot assign a string to an 
int value. 
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Q3) We talked a lot about operators and how different operators can be used together 
to build complicated expressions. Expressions, at a glance, can sometimes make code 
look complicated. However, when looked at closely, they are not as tough as they 
seem. Usually, it is just a case of splitting the expressions into smaller pieces to work 
out what is going on. Here is an expression that is more convoluted than anything 
else you will ever meet in this book. As a challenge, can you work out what x will be? 

int x = 10; 
int y = 9; 

boolean isTrueOrFalse = false; 

isTrueOrFalse = ( ( (x <=y) | | (x == 10) )&&((! isTrueOrFalse) j| 
(isTrueOrFalse) ) ) ; 

A) You can run the Self TestC3Q3 project in the Chapter3 folder of the code 
bundle to check out the answer in the console, but isTrueOrFalse evaluates 
to true; here's why. 

First, let's break down the nasty line into manageable sections defined by the brackets: 

( (x <=y) I I (x == 10) ) 

Previously, we were asking the question, "is x less than or equal to y or is x exactly 
equal to io?". Clearly, x is not equal to or less than y but x is exactly equal to 10 , so 
our use of the logical OR operator, | | , in the middle causes the entire part of the 
expression to evaluate to true. 

&& 

Both sides of an && operator must evaluate to true for the overall expression to be 
true. So let's look at the other side: 

((! isTrueOrFalse) || (isTrueOrFalse))) 

Well, isTrueOrFalse is a Boolean. It can only be true or false so this part of the 
expression must be true because we are essentially asking, "is isTrueOrFalse false 
or is isTrueOrFalse true?". It must be one or the other. So, regardless of how we 
initialized isTrueOrFalse, the last part of the expression will be true. 

So the overall expression evaluates to true, and true is assigned to isTrueOrFalse. 
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Chapter 4 

Ql) What is wrong with this method? 

void doSomething ( ) { 
return 4 ; 

} 

A) It returns a value but has a void return type. 

Q2) What will x be equal to at the end of this code snippet? 

int x=19; 
do{ 

x=ll ; 
x++ ; 

}while (x<2 0 ) 

A) Okay, this was a slightly tricky question. Regardless of the value of x, the do block 
always executes at least once. Then x is set to 1 1, and after that, it is incremented to 
12. So when the while expression is evaluated, it is true and the do block executes 
again. Once more, x is set to li and then incremented to 12 . The program is stuck in 
a never-ending (infinite) loop. This code is most likely a bug. 

Chapter 5 

with 

multidimensional arrays? 
this: 

String [] [] countriesCitiesAndPresidents; 

//now allocate like this 
countriesAndCities = new String [5] [3] ; 

//and initialize like this 

countriesCitiesAndPresidents [0] [0] = "United Kingdom"; 
countriesCitiesAndPresidents [0] [1] = "London"; 

countriesCitiesAndPresidents [0] [3] = " Cameron" ; //at time of writing 
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to a file so 
s like asking 

the user to click on a Save button. Summoning all your knowledge of Chapter 2, 
Getting Started with Android, can you think of a way to save the string without 
saving it by the button click but just when the user quits the app? 

A) Override the onPause life cycle method and put the code to save the string in 
there, like this: 

©Override 

protected void onPause () { 

editor . putString ( stringName , currentstring) ; 
editor . commit ( ) ; 

} 


Q3) Other than increasing the difficulty level, how could we make the memory 
game harder? 

lower 

number, giving the player less thinking time, like this: 

myHandler . sendEmptyMessageDelayed ( 0 , 450) ; 

//This halves the players thinking time 

Q4) Using the plain Android UI with the dull grey buttons isn't very exciting. Take 
o use an 

image for our button background? 

A) Simply add some .png graphics to the drawable-mdpi folder and then find 
the background property in the Properties window while your button is selected. 
Click to edit the property in the usual way and choose the graphic you added to the 
drawable-mdpi folder. 

Chapter 6 

Ql) What is encapsulation? 

A) Encapsulation is the way we pack our variables, code, and methods in a manner 
that exposes just the parts and functionality we want to the parts of our app (or any 
app that uses our classes) that we want. 
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I had at the start 

of the chapter. What should I do? 

A) You know enough about OOP to make significant progress with games and any 
ght now, 

there are plenty of highly rated books that discuss nothing but OOP. However, 
practice and familiarity with the syntax will go a long way to achieving the same 
thing and will probably be more fun. The deciding factor in whether you rush off 
rsonal goals 
the last 

few pages of Chapter 9, Making Your Game the Next Big Tiring, for more discussion. 

Chapter 7 

ve different 
ely the 

same on different screen resolutions? 

A) A simple way to accommodate different screen resolutions would be to devise 
a system that that takes into account the number of pixels the screen has. We have 
already done this for the racket and ball sizes. We could declare a member variable 
like this: 

int pixelsPerFrameX; 
int pixelsPerFrameY; 

We could then initialize these variables in onCreate after we have obtained the 
screen dimensions: 

pixelsPerFrameX = screenWidth/50 ; 
pixelsPerFrameY = screenHeight/50 ; 

Then we can move our ball a bit, like this: 

//moving in adjust our x any positions 
if (balllsMovingDown) { 

ballPosition . y += pixelsPerFrameX; 

} 

//etc. . . 
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Chapter 8 

/ Kg** 

green grassy background instead of just black? 

A) You can use most graphics programs such as Gimp or Photoshop to get the 
e an online 

color picker such as http : //www . colorpicker . com/. Then look at this line in our 
drawGame method: 

canvas . drawColor (Color . BLACK) ; //the background 

Change it to the following line: 

canvas . drawColor (Color . argb (255, 186,230, 177) ) ;// the background 

Q2) How about adding some nice flowers to the background? 

A) Here is the way to do this. Create a flower bitmap (or use mine), load it, and scale 
it in the usual way, in the conf igureDisplay method. Decide how many flowers to 
draw. Choose and store locations on the board in the Snakeview constructor (or write 
and call a special method, perhaps plantFlowers). 

Draw them before the snake and the apple in the drawGame method. This will ensure 
that they can never hide an apple or a part of the snake. You can see my specific 
implementation in the methods mentioned and a copy of the flower bitmap in the 
EnhancedSnakeGame project in the Chapters folder. 

Q3) If you're feeling brave, make the flowers sway. Think of sprite sheets. The theory 
ew lines of 

code to control the frame rate separately from the game frame rate. 

A) Take a look at the new code in the controlFPS method. We simply set up a new 
counter for flower animations to switch flower frames once every six game frames. 
You can also copy the sprite sheet from the EnhancedSnakeGame project in the 
Chapters folder. 
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Q4) We could set up another counter and use our snake head animation, but it 
wouldn't be that useful because the subtle tongue movements would be barely visible 
due to the smaller size. Nevertheless, we could quite easily swish the tail segment. 

A) There is a two-frame tail bitmap in the EnhancedSnakeGame project in the 
Chapters folder. As this is also two frames, we could use the same frame 
timer as that used for the flower. Take a look at the implementation in the 
EnhancedSnakeGame project in the Chapters folder. The only required 
changes are in conf igureDisplay and drawGame. 

Q5) Here is a slightly trickier enhancement. You can't help notice that when the 

hey don't look 

right. Can you fix this? 

oid has 

a Matrix class, which allows us to easily rotate Bitmaps, and the Bitmap class has 
an overloaded version of the createBitmap method that takes a Matrix object as 
an argument. 

So we can create a matrix for each angle we need to handle, like this: 

Matrix matrix90 = new Matrix () ; 
matrix90 .postRotate (90) ; 

Then we can rotate a bitmap using the following code: 

rotatedBitmap = Bitmap . createBitmap (regularBitmap , 0, 0, 
regularBitmap .getWidthO, regularBitmap . getHeight ( ) , matrix90, 
true) ; 


ack 

on finding 

scheme: 0 is up, 1 is right, and so on. So we can just create another array for the 
orientation of each segment that corresponds to a body segment in the snakeX and 
snakeYct 
snake's 

coordinates. You can see this implemented in the EnhancedSnakeGame project in 
the Chapters folder. 
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The finished project with a few more enhancements is in the EnhancedSnakeGame 
project in the chapters folder. This is the version we will be using as a starting 
point in the next and final chapter. You can also download the game from Google 
Play at https : //play . google . com/ store/apps/details?id=com.packtpub . 
enhancedsnakegame . enhancedsnakegame. 




a 
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Self-test Questions and Answers 

Chapter 9 

Ql) Try to implement the local high scores on the device. 

A) You already know how to do this. Just go back to Chapter 5, Gaming and Java 
Essen twister's 
project as well. 

Q2) How many eminent computer scientists have made cameo appearances in the 
code throughout this book? 

A) 9 

Ada Lovelace 
Charles Babbage 
Alan Turing 
Vinton Cerf 
Jeff Minter 
Corrine Yu 
Andre LaMothe 
Gabe Newell 
Sid Meier 

Why not search on the Web for some of these names? There are some interesting 
stories about each of them. 
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